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Preface 


" Document Object 
The document describes the introcudtion, use method and detail APIs about Device API provided by Samsung 


Smart TV products 


= Document Scope 
The document describes only Device API provided by Samsung Smart TV products. The guideline documents like 


development or UI is cared by other documents 
= Document Subject 


The document is subject to the developers who have the basic understanding about digital TV and javascript 


language 
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1. Device API Introduction 


1.1. What is Device API? 


о  DeviceAPI is defined as follows : API which widget uses when Javascript function does not support 
TV function (ex : Channel change ) 
- DeviceAPI can be called as Javascript 
- DeviceAPI can be called as method call or callback, which means that it can have a 
characteristic of bidirectional communication 
- DeviceAPI is coupled with browser 


- DeviceAPI has the limited expression and use such like data expression of structure or array 


o Samsung DeviceAPI can be different for each product 


- DeviceAPI is dependent on Samsung native modules, and products can have different modules 
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1.2. Architecture 


o Widget can call Device API which supports the Samsung Device functions layered with various 
Device modules such as Channel. 
o  DeviceAPI layer behaves like the language binding between С++/С and Javascript 
о Тһе Samsung Smart TV is composed of two main layers : Widget and Samsung Engine 
- Widget is made by web script languages including HTML, XML, CSS, and Javascript 
- Samsung Engine has many TV modules, and Device API is entering point to them by widget 


- Device API is made as binary image, and can be not changed with arbitrary requirements 


1.3. Version Policy 


o Each API in Device API can have the version as additional function, and can be managed with each 
version number 


o Version description format: [Device APIName]-[xxxx] ex) TVMW-0005 
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2. Use Method of Device API 


2.1. DeviceAPI Object Definition (HTML) 


o Declare the use of DeviceAPI using html object tag 
o Declared as clsid attribute in object tag 


o Other attributes are optional except clsid 


<object id="pluginObjectAudio" border=0 classid="'clsid:SAMSUNG-INFOLINK-AUDIO" 
style="opacity:0.0;background-color:#000000;width:Opx;height:0px;"> </object> 


2.2. Variable Declaration of DeviceAPI Type (Javascript) 


о Defined as DeviceAPI variable using GetElementB yID or embed 


var AudioPlugin = document.getElementById("pluginObjectAudio"); 
Or 


var AudioPlugin - document.embeds[0]; 
2.3. DeviceAPI Operation 


o Function call 
AudioPlugin.GetVolume(); 
o Registration of function callback 


function OnMuteCallback(mute) { 
alert(mute); 


) 
AudioPlugin.OnMute = OnMuteCallback; 


// when OnMute event happens on TV (TV becomes mute), OnMuteCallback function is called 
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3. Device API List 


3.1. Common 


ommon 


Common plugin is not a real plugin. This is a virtual plugin to describe common functions of all plugins 


Latest Version none 
CLSID none 


tPluginInf 


Event 


е Number 
5 е РІ, СММ INFO 
Enumeration 
e String 


3.2. AppCommon 


AppCommon 


TV Plugin deals with basic functions of TV ( ex : Key Registration, etc... ) 


Latest Version AppCommon -0010 
CLSID clsid:S AMSUNG-INFOLINK-APPCOMMON 


CheckReservedKey 
IsKeyRegister 
RegisterAllKey 
RegisterColorKey 
RegisterKey 
Function 
RegisterNaviKey 
RegisterNumKey 
RegisterPlaybackKey 
SendEvent IME 
SendEvent IME Sync 
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SendKeyToTV Viewer 
SubscribeEvent 
UnregisterAllKey 
UnregisterColorKey 
UnregisterKey 
UnregisterNaviKey 
UnregisterNumKey 
UnregisterPlaybackKey 
UnsubscribeEvent 


ЕО 
Event 
е PL APPCOMMON KEY 
Enumeration е PL APPCOMMON MESSAGE 


3.3. Audio 


Audio 


Audio module supports to control audio relative functions(ex: Volume, Mute, etc) of DTV platform. 


CLSID elsid:SAMSUNG-INFOLINK-AUDIO 


CheckExternalOutMode 
GetExternalOutMode 
GetOutputDevice 
GetSystemMute 
GetUserMute 
Function GetVolume 
IsActiveSourceOnCEC 
SetExternalOutMode 
SetSystemMute 
SetTVSourceOnCEC 
SetUserMute 
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ШЕШЕ е  SetVolumeWithKey 


е PL AUDIO AUDIO OUT MODE 
. e РІ, AUDIO OUTPUT DEVICE 
Enumeration 
е PL AUDIO VOLUME KEY 


3.4. DEVICE 


Device 


Device module supports to control H/W relative functions of DTV platform.(ex: panel) 


Latest Version DEVICE-0002 
CLSID clsid:SAMSUNG-INFOLINK-DEVICE 


GetDisplayPanelType (Replaced) 
Function GetMedel (Replaced) 
GetRealMedel (Replaced) 


PL-DEVICE-DPT (R 


3.5. EXTERNALWIDGETINTERFACE 


ExternalWidgetInterface 


XXX 


Latest Version EXTERNALWIDGETINTERFACE-0004 


CLSID elsid:SAMSUNG-INFOLINK-EXTERNALWIDGETINTERFACE 


AccountRead 

AccountRemove 
Function 

AccountWrite 

GetESN 
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е  IsBound 
e UnBindWidget 


3.6. Download 


Download 


Download module supports to asynchrornus download file to DTV platform throughout HTTP, HTTPS protocol. 


CLSID clsid:S AMSUNG-INFOLINK-DOWNLOAD 


CancelDownload 

CancelUpload 

CheckDownloadSpeed 

Function 

StartDownFile 

StartUpload 

OnComplete 

load let 

Event OnUploadComplete 

OnUploadProgress 

PL_DN_ST 

Enumeration PL_DOWNLOAD_UPLOAD_SERVER_TSERVER_TYPE 


3.7. Filesystem 


FileSystem 


Filesystem module support to control FileSystem in DTV Platform. ( ex : copy, move, unzip ) 


Latest Version FILES YSTEM-0005 


CLSID clsid:S AMSUNG-INFOLINK-FILES YSTEM 
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Function 


3.8. FrontPanel 


FrontPanel 


FrontPanel Plugin deals with Display of BD Player 
Latest Version FrontPanel-0003 


CLSID clsid:S AMSUNG-INFOLINK-FRONTPANEL 


е DisplayVFD Show 
Function е  DisplayVFD Time 


3.9. IME 


IME 
CLSID clsid:SAMSUNG-INFOLINK-IME 


Пеш МЕ 
DeInitMyWordIMB 
GetActiveWordPosition 
Function GetCharacterList 
GetCursorPosition 
GetIMEInputMode 
GetLanguage 
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GetRecommendedString 
GetRecommendedStringCount 
GetShfCapState 
GetString 

InitIME 
InitMyWordIME 
InputKey 
ResetUDBData 
SetCursorPositon 
SetIMEInputMode 
SetLanguage 

SetString 


3.10.ImageViwer 


ImageViewer 


Plugin to display JPEG image 


Latest Version IMAGEVIEWER-0001 
CLSID elsid:SAMSUNG-INFOLINK-IMAGEVIEWER 


ClearScreen 
GetVideoHeight 
GetVideoWidth 
InitPlayer 


Play 
Function SetDisplayArea 


SetDisplayLock 
SetTransitionEffect 
Showlmage 


Stop 


OnBufferingComplete 
OnBufferingStart 


OnConnectionFailed 
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OnNetworkDisconnected 


OnRenderError 


OnRenderingComplete 


OnStreamInfoReady 
OnStreamNotFound 


3.11.Network 


Network 


Network module support to control and get network relative informations in DTV platform. 


Latest Version NETWORK-0004 
CLSID clsid:SAMSUNG-INFOLINK-NETWORK 


CheckCableConnection 
CheckDNS 
CheckGateway 
CreatePlugin 
GetActiveType 
GetDNS 
GetGateway 

Function GetHostAddr 
GetHWaddr 


GetIpType 
GetNetMask 


GetStatus 
HttpTest 
IPConflictTest 
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3.12.NNavi 


NNavi module supports to control Samsung Smart TV specific functions in DTV platform. (ex: DUID, ServerType, 


etc.) 


Latest Version NNAVI-0007 
CLSID clsid:SAMSUNG-INFOLINK-NNAVI 


ActivateReady 
ActivateWithData 
ChangeWidgetManager 
GetAppKey 
GetDUID 
GetFirmware 
GetModelCode 
GetPath 

Function GetRemoconType 
GetServerType 
GetSupportPIG 
GetSystem Version 
GetToken 
ResetWidgetData 
SendEventToDevice 


SetBannerState 


е PL NNAVI PATH 
. е PL NNAVI SYSTEM VERSION 
Enumeration 
e PLST 


3.13.PLAYER 


| Player 


@Samsung Electronics Copyright АП Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


Plugin for multimedia playback. 


PLAYER-0006 
elsid:SAMSUNG-INFOLINK-PLAYER 

е ClearScreen 
e  GetAvailableBitrates 
e  GetCurrentBitrates 
е GetDuration 
е GetPlayerVersion 
. GetVideoHeight 
е GetVideoWidth 
e  InitPlayer 
е JumpBackward 
е JumpForward 
e Pause 
e Play 
е Resume 

Function е  ResumePlay 
е  SetCropArea 
е SetDisplayArea 
е SetICT 
е SetInitialBuffer 
е  SetInitialTimeOut 
e  SetMacrovision 
е SetPendingBuffer 
е SetPlaybackSpeed 
е  SetTotalBufferSize 
е SetVBIData 
е StartPlayback 
е Stop 
е OnAdEnd 
e OnAdStart 

Event е OnAuthenticationFailed 

е OnBufferingComplete 
е  OnBufferingProgress 
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е OnBufferingStart 

е OnConnectionFailed 

е OnCurrentPlayTime 

е OnNetworkDisconnected 
е OnRenderError 

е OnRenderingComplete 

е OnResolutionChanged 

е OnStreamInfoReady 

. OnStreamNotFound 


Enumeration none 


3.14.Screen 


Screen 


Screen Plugin deals with screen functions of TV ( ex : 3DEffect ) 


SCREEN-0004 
elsid:SAMSUNG-INFOLINK-SCREEN 


Check3DEffectMode 

Flag3DEffectSupport 

Get3DEffectMode 
Function GetOption 


Set3DEffectMode 


Event 


е PL SCREEN 3DEFFECT MODE 
Enumeration е PL SCREEN OPTION 
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3.15.TaskManager 


TaskManager 


TaskManager plugin deals with intertask action of TV ( ex : GetActiveApplication etc... ) 


Latest Version TASKMANAGER-0003 
CLSID clsid:SAMSUNG-INFOLINK-TASKMAN AGER 


Activate Application 

GetActive Application 
Function GetBgApplication 

SetBgApplication 


Event 


e РІ. TASKMANAGER DTVAPP 
Enumeration 


3.16.Time 


Time 


Time plugin deals with time functions of TV ( ex : GetEpochTime, etc... ) 


CLSID clsid:SAMSUNG-INFOLINK-TIME 


е ConvertEpochToLocalTime 
Function e GetEpochTime 


3.17. TV 
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TV 
TV Plugin deals with basic functions of TV ( ex : EPG, Callback event, etc... ) 
CLSID elsid:SAMSUNG-INFOLINK-TV 


CheckPIP 
FlagStreamDST 
GetBDProductType 
GetCountry 
GetDisplayPanelType 
GetDST 
GetLanguage 
GetLanguageSet 
GetPIP 
GetPresentProgram_Duration 
GetPresentProgram_EndTime 
GetPresentProgram_StartTime 
GetPresentProgram_Title 
Function GetProductCode 
GetProductType 
GetProgram_Duration 
GetProgram_EndTime 
GetProgram_StartTime 


GetProgram_Title 


GetProgramList 


GetProgramList Size 
GetTargetLocation 
GetTimeZone 
GetTimeZone Offset 
SetEvent 

SetPIP 


UnsetEvent 


е OnEvent 
Event 


e РІ, ТУ BDPRODUCT TYPE 
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PL TV COUNTRY 

PL TV DISPLAY PANEL 

PL TV DST TYPE 

PL TV EVENT 

PL TV FACTORY LANGUAGE 


PL TV LANGUAGE 

PL TV PRODUCT TYPE 

PL TV TARGET LOCATION 
PL TV TIMEZONE 


3.18.TVMW 


TVMW module supports to control various functionality about basic application, language, contry, input source(T'V, 


HDME, etc.), key registration, etc. in DTV platform. 


CLSID clsid:SAMSUNG-INFOLINK-TVMW 


CheekReservedKey (Replaced) 
Deaetivate (Replaced) 
GetActiveApp (Replaced) 
GetBGApp (Replaced) 
GetCountry (Replaced) 
GetLanguage (Replaced) 
GetProfile 

Function GetSeuree (Replaced) 
GetPVUseMede (Replaced) 
IsRegisteredKey (Replaced) 
RegForBGApp (Replaced) 
RegisterKey (Replaced) 
RegisterKeyGroup (Replaced) 
SendKeyToTV Viewer (Replaced) 
SetProfile 
SetSeuree (Replaced) 
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SetWatehDos (Replaced) 
UnregForBGApp (Replaced) 
UnresisterKey (Replaced) 
UnregisterKeyGroup (Replaced) 


Event 


PE. FVMW COUNTRY (Replaced) 

PE. ТУМА DTVAPP (Replaced) 

PE. FVMW KEY (Replaced) 

PE TVMW KEY GRP (Replaced) 
И РЕ-ТУМУ\У/ LANGUAGE (Replaced) 

PL TVMW PRFID 

PE. ТУМА SOURCE (Replaced) 

PE. ТУМА TVUT (Replaced) 

PL-FVMW-WATCHDGG (Replaced) 


3.19.VIDEO 


Video 


Video module supports to control Video relative functions in DTV platform. (ex: Screen state, etc.) 


Latest Version VIDEO-0005 
CLSID clsid:SAMSUNG-INFOLINK-VIDEO 


Change WidgetMode 
SetErameRate 

Function (Replaced) 
SetOSDState 


e PL VIDEO WIDGET MODE 
Enumeration 


3.20. WINDOW 
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Window 


Window Plugin deals with basic functions of TV ( ex : Screen, Channel, etc... ) 
Latest Version WINDOW:-0005 
CLSID elsid:SAMSUNG-INFOLINK-WINDOW 


CheckScreenRect_PosSizeMode 

GetCurrentChannel_Major 

GetCurrentChannel_Minor 

GetCurrentChannel_Name 

GetCurrentChannel OriginNetID 

GetCurrentChannel ProgramNumber 

GetCurrentChannel PTC 

GetCurrentChannel ServiceName 
Function GetCurrentChannel Type 

GetResolution 

GetScreenRect 

GetScreenRect PosMode 

GetScreenRect SizeMode 

GetSource 

GetState Show 

SetSource 


Event 


PL WINDOW CHANNEL TYPE 

PL WINDOW NAVIGATOR MODE 

PL WINDOW POSITION MODE 

PL WINDOW RECT SIZE MODE 
pamaraan PL WINDOW RESOLUTION 

PL WINDOW SEEK 

PL WINDOW SHOW STATE 

PL WINDOW SHOW TYPE 

PL WINDOW SOURCE 
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4. Device API Functions Detail 


4.1. COMMON 
4.1.1. Function 


4.1.1.1. GetPluginInfo 


Function 


GetPluginInfo 


GetPluginInfo get DeviceAPI Info 


Return Value 


Emulator 
remarks 


Security Type 


4.1.2. Enumeration 


4.1.2.1. Number 


Enumeration 
Number 


Interger Type( not real number) 


Remarks none 
Emulator 
none 
remarks 
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Value 


4.1.2.2. PL_CMN_INFO 


Enumeration 


PL_CMN_INFO 


Device API common information 
Remarks 


Emulator 
none 
remarks 
GetPluginlnf: 


e 0 - PL CMN INFO VERSION 
Value o Plugin version 


4.1.2.3. String 


Enumeration 


String 


String Type 


Emulator 


remarks 
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4.2. AppCommon 
4.2.1.Function 


4.2.1.1. CheckReserved Key 


Function 
CheckReservedKey 


CheckReservedKey function return whether TV Viewer reserve this key or not. 


CheckReservedKey( РІ, APPCOMMON KEY key) 


. key 
о PL APPCOMMON KEY 
Parameter 
о 
If reserved, returns 1. 
Return Value If not reserved, reutrn 0. 
Otherwise, returns error code. 


Remarks 


Emulator 
Only returns true 
remarks 


if( 1 == AppCommonPlugin.CheckReservedKey(key) ) 
| 
Example AppCommonPlugin.SendKeyToTV Viewer(key); 


Support from APPCOMMON-0010 
Security Type TVInfo 


4.2.1.2. IsKeyRegister 


Function 


IsKeyRegister 


IsKeyRegister function returns whether a key is registered or not 


IsKeyRegister( ) 
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ЕЧ If registered, return 1, 

Return 

If not registered, return 0, 

Value 

If function fails, returns negative value 


Emulator 
Only returns true 
remarks 


function OnLoadFunc() 


{ 


AppCommonPlugin = document.getElementB yId( PluginAppCommon; 


document.getElementB yId(categoryID + '1').focus(); 
if( 0 == 


AppCommonPlugin.IsKeyRegister(PL APPCOMMON KEY JOYSTICK ОК)) 
| 


Example 


AppCommonPlugin.RegisterNumberKey(PL APPCOMMON KEY JOYST 
ICK OK); 


Enumerati 
none 
on 


Support from APPCOMMON-0004 


Security 
TVInfo 
Type 


4.2.1.3. Register AlIKey 


Function 


Register AlIKey 


Register AlIKey function register all key 
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If success, returns positive value 
Return Value . | 
otherwise, returns negative value 
Remarks You can receive only registered keys 


Emulator . | е 
You сап receive all keys without registering keys. 
remarks 


function OnLoadFunc() 


{ 


AppCommonPlugin = 


document.getElementByld('PluginAppCommon'); 
Example document.getElementByld(categoryID + '1').focus(); 


AppCommonPlugin.RegisterAlIKey(); 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.4. RegisterColorKey 


Function 
RegisterColorKey 


RegisterColorKey function register color keys 


RegisterColorKey( ) 


If success, returns positive value 
Return Value . . 
otherwise, returns negative value 


You can receive only registered keys. 
Remarks 
Navigation keys are KEY GREEN, KEY YELLOW, KEY CYAN,KEY RED 


Emulator 


You can receive all keys without registering keys. 
remarks 


function OnLoadFunc() 
Example { 
AppCommonPlugin = 
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document.getElementB yId('PluginAppCommon?; 
document.getElementB yId(categoryID + '1').focus(); 


AppCommonPlugin.RegisterNumberKey(); 


AppCommonPlugin.RegisterNaviKey(); 


AppCommonPlugin.RegisterColorKey(); 
AppCommonPlugin.RegisterPlaybackKey(); 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.5. RegisterKey 


Function 
RegisterKey 


RegisterKey function register key 


RegisterKey( PL APPCOMMON KEY key) 


PL APPCOMMON KEY 
Parameter 
key value 


Return If success, returns positive value 
Value otherwise, returns negative value 


You can receive only registered keys. 


Emulator | : Е 
You сап receive all keys without registering keys. 
remarks 


function OnLoadFunc() 
{ 
и ; AppCommonPlugin = document.getElementB yId(‘PluginAppCommon’); 
xampie 
й document.getElementB yId(categoryID + '1').focus(); 
AppCommonPlugin.RegisterKey(PL APPCOMMON KEY JOYSTICK O 
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| AppCommonPlugin.RegisterKey(PL APPCOMMON KEY JOYSTICK О 
| AppCommonPlugin.RegisterKey(PL APPCOMMON KEY JOYSTICK D 
AGERE RegisterKey(PL APPCOMMON KEY JOYSTICK L 
AppCommonPlugin.RegisterKey(PL APPCOMMON KEY JOYSTICK КІ 


Enumeratio 
none 
n 


Support from APPCOMMON-0004 


Security 
TVInfo 
Type 


4.2.1.6. RegisterNaviKey 


Function 
RegisterNaviKey 


RegisterNaviKey function register navigation keys 


If success, returns positive value 
Return Value . . 
otherwise, returns negative value 


You can receive only registered keys. 
Navigation keys are KEY JOYSTICK OK, KEY JOYSTICK, UP, KEY JOYSTICK DOWN, 
Remarks 
KEY JOYSTICK LEFT, KEY JOYSTICK RIGHT, KEY WHEEL LEFT, 
KEY WHEEL RIGHT 
Emulator 
You can receive all keys without registering keys. 
remarks 
function OnLoadFunc() 
Example | 
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AppCommonPlugin = 


document.getElementB yId(‘PluginAppCommon'’); 


document.getElementB yId(categoryID + '1').focus(); 


AppCommonPlugin.RegisterNumberKey(); 
AppCommonPlugin.RegisterNaviKey(); 
AppCommonPlugin.RegisterColorKey(); 
AppCommonPlugin.RegisterPlaybackKey(); 


Enumeration none 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.7. RegisterNumKey 


Function 


RegisterNumKey 


RegisterNumKey function register number keys 


ОСЕ ШЕШЕН 
Return Value 
otherwise, returns negative value 
EG “fa 
Remarks 
Number keys are KEY 0 - KEY 9 


Emulator . . M 
You can receive all keys without registering keys. 
remarks 


function OnLoadFunc() 
{ 
AppCommonPlugin = 
Example document.getElementB yId(‘PluginAppCommon'); 
document.getElementB yId(categoryID + '1').focus(); 
AppCommonPlugin.RegisterNumberKey(); 
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AppCommonPlugin.RegisterNaviKey(): 
AppCommonPlugin.RegisterColorKey(): 
AppCommonPlugin.RegisterPlaybackKey(); 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.8. RegisterPlaybackKey 


Function 
RegisterPlaybackKey 


RegisterPlaybackKey function register color keys 


RegisterPlaybackKey( ) 


If success, returns positive value 
Return Value 

otherwise, returns negative value 
You can receive only registered keys. 

Remarks Navigation keys are KEY REWIND, KEY STOP, KEY PLAY, 
KEY FF, KEY REC, KEY PAUSE 

Emulator 
You can receive all keys without registering keys. 

remarks 


function OnLoadFunc() 

{ 
AppCommonPlugin = 

document.getElementB yId(‘PluginAppCommon'’); 
document.getElementB yId(categoryID + '1').focus(); 

Example 

AppCommonPlugin.RegisterNumberKey(); 
AppCommonPlugin.RegisterNaviKey(); 
AppCommonPlugin.RegisterColorKey(); 
AppCommonPlugin.RegisterPlaybackKey(); 
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Enumeration 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.9. SendEvent IME 


Function 
SendEvent МЕ 


SendEvent_IME function start and stop sending key input to external device(ex : handset, mp3) 


when key is inputed between start and stop, that key is sent to external device. 


SendEvent IME( Number nStart , Number inputType , Number charProsessingType , 
Syntax 
Number extraOption ) 


e  nStart 
o Number 
o І: start, 0: stop 
e inputType 
o Number 
о 1: Input, 2: ТЕХТАКЕА, 4: PASSWORD 
Parameter е charProsessingType 
o Number 
o 8:CharByChar, 16 : FullString 
e  extraOption 
o Number 
о 32 : ТоузисКеу, 64: NumberKey, 128 : SpecialKey, 256 : NumberKey 


If success, returns 1. 
Return Value . 
Otherwise, returns error code. 
Remarks 


Emulator 
none 
remarks 


if( 1 Z2 AppCommonPlugin.CheckReservedKey(key) ) 
{ 
Example . Р 
AppCommonPlugin.SendKeyToTV Viewer(key); 
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4.2.1.10. SendEvent IME Sync 


Function 
SendEvent IME Sync 


SendEvent IME Sync function send string to external device(ex : handset, mp3) for sync 


SendEvent IME Sync(String string ) 


e string 
o String 
Parameter 
o string to send to external devicel: start(ex : handset, mp3) 


If success, returns 1. 
Return Value . 
Otherwise, returns error code. 
Remarks 


Emulator 
none 
remarks 


OnKeyInputStartFromExternalDevice() 
{ 
AppCommonPlugin.SendEvent IME(1, 1, 8, 32); 
OnKeyInputEndFromExternalDevice() 
{ 
Example AppCommonPlugin.SendEvent IME(0, 0, 0, 0); // When stop, only 
first parameter is used. 
) 
OnSyncToExternalDevice() 
{ 
AppCommonPlugin.SendEvent_IME_Sync(inputtext.value); 
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none 


Support from APPCOMMON-0010 
TVInfo 


4.2.1.11. SendKeyToTV Viewer 


Function 
SendKeyToTV Viewer 


SendKeyToTV Viewer function send key to TV Viewer. 


SendKeyToTV Viewer( PL APPCOMMON KEY key) 


. key 
o PL APPCOMMON KEY 
Parameter 
[9] 


If success, returns 1. 
Return Value . 
Otherwise, returns error code. 
Remarks 


Emulator 
Only returns true. 
remarks 


ІШІ == AppCommonPlugin.CheckReservedKey(key) ) 
{ 
Example AppCommonPlugin.SendKeyToTV Viewer(key): 


Support from APPCOMMON-0010 
Security Type TVInfo 


4.2.1.12. SubscribeEvent 


Function 


SubscribeEvent 
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SubscribeEvent function registers message to receive callback 


SubscribeEvent( PL APPCOMMON MESSAGE message ) 


е message 
о РІ, APPCOMMON MESSAGE 


o Message to register 


If success, returns positive value 


otherwise, returns negative value 


none 


none 


function OnLoadFunc() 
document.getElementB yId(categoryID + '1').focus(); 
AppCommonPlugin = document.getElementB yId(‘PluginAppCommon’); 


AppCommonPlugin.SubscribeEvent(PL APPCOMMON MESSAGE INPU 
T OCCUR); 
AppCommonPlugin.OnMessage - OnMessage; 


function OnUnloadFunc() 


{ 
AppCommonPlugin.UnsubscribeEvent(PL_APPCOMMON_MESSAGE_INP 
UT OCCUR); 


) 


function OnMessage(id) 


alert( "OnMessage id=[" + id + "]"); 
switch( parselnt(id) ) 
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case РІ, APPCOMMON MESSAGE IME INPUT: 

{ 
Шеті СРІ, APPCOMMON MESSAGE ІМЕ INPUT): 
document.getElementById('OnMessage').value = "[" + id 
break; 


е PL APPCOMMON MESSAGE 
on 


Support from APPCOMMON-0001 


Security 
TVInfo 
Type 


4.2.1.13. UnregisterAllKey 


Function 
UnregisterAllKey 


UnregisterAllKey function unregister all key 


If success, returns positive value 
Return Value . | 
otherwise, returns negative value 


You can receive only registered keys 


Emulator 
None 
remarks 


function OnUnloadFunc() 
{ 
Example AppCommonPlugin = 
document.getElementB yld(‘PluginA ppCommon'’); 
document.getElementB yId(categoryID + '1').focus(); 
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ши AppCommonPlugin.UnregisterAllKey(); 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.14. UnregisterColorKey 


Function 
UnregisterColorKey 


UnregisterColorKey function unregister color keys 


UnregisterColorKey( ) 


If success, returns positive value 
Return Value 
otherwise, returns negative value 
You can receive only registered keys. 
Remarks 
Navigation keys are KEY GREEN, KEY YELLOW, KEY СҮАМ,КЕҮ RED 
Emulator 
You can receive all keys without registering key. 
remarks 


function OnLoadFunc() 

{ 
AppCommonPlugin = 

document.getElementByld('PluginAppCommon'); 
document.getElementB yId(categoryID + '1').focus(); 

Example 

AppCommonPlugin.UnregisterNumberKey(); 
AppCommonPlugin.UnregisterNaviKey(); 
AppCommonPlugin.UnregisterColorKey(); 
AppCommonPlugin.UnregisterPlaybackKey(); 
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Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.15. UnregisterKey 


Function 
UnregisterKey 


UnregisterKey function unregister key 


UnregisterKey( РІ, APPCOMMON KEY key ) 


PL APPCOMMON KEY 
Parameter 
key value 


Return If success, returns positive value 
Value otherwise, returns negative value 
Remarks | You can receive only registered keys. 


Emulator 
You can receive all keys without registering key. 
remarks 


function OnLoadFunc() 
{ 
AppCommonPlugin = document.getElementB yId('PluginAppCommon?; 
document.getElementB yId(categoryID + '1').focus(); 
AppCommonPlugin.UnregisterKey(PL APPCOMMON KEY JOYSTICK 
OK); 
AppCommonPlugin.UnregisterKey(PL APPCOMMON KEY JOYSTICK 
Example | UP); 
AppCommonPlugin.UnregisterKey(PL APPCOMMON KEY JOYSTICK. 
DOWN); 
AppCommonPlugin.UnregisterKey(PL APPCOMMON KEY JOYSTICK 
LEFT); 
AppCommonPlugin.UnregisterKey(PL APPCOMMON KEY JOYSTICK 
RIGHT); 
| 
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Enumeratio 


Version Support from APPCOMMON-0004 


Security 


Type 


TVInfo 


4.2.1.16. UnregisterNaviKey 


Function 
UnregisterNaviKey 


UnregisterNaviKey function unregister navigation keys 


UnregisterNaviKey( ) 


If success, returns positive value 
Return Value | : 
otherwise, returns negative value 


You can receive only registered keys. 

Navigation keys are KEY JOYSTICK OK, KEY JOYSTICK UP, KEY JOYSTICK DOWN, 
zu KEY_JOYSTICK_LEFT, KEY JOYSTICK RIGHT, KEY WHEEL LEFT, 

KEY WHEEL RIGHT 


Emulator 
You can receive all keys without registering key. 
remarks 
function OnLoadFunc() 
{ 
AppCommonPlugin = 
document.getElementByld('PluginAppCommon'); 
document.getElementB yId(categoryID + '1').focus(); 
Example : Е 
AppCommonPlugin.UnregisterNumberKey(); 
AppCommonPlugin.UnregisterNaviKey(): 
AppCommonPlugin.UnregisterColorKey(): 
AppCommonPlugin.UnregisterPlaybackKey(); 
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Support from APPCOMMON-0004 


Security Type TVInfo 


4.2.1.17. UnregisterNumKey 


Function 


UnregisterNumKey 


UnregisterNumKey function unregister number keys 
If success, returns positive value 
Return Value 
otherwise, returns negative value 
You can receive only registered keys. 
Remarks 
Number keys are KEY 0 - KEY 9 
Emulator 
You can receive all keys without registering key. 
remarks 
function OnLoadFunc() 
{ 
AppCommonPlugin = 
document.getElementB yId( PluginAppCommon?); 
document.getElementB yId(categoryID + '1').focus(); 
Example Е : 
AppCommonPlugin.UnregisterNumberKey(); 
AppCommonPlugin.UnregisterNaviKey(); 
AppCommonPlugin.UnregisterColorKey(); 
AppCommonPlugin.UnregisterPlaybackKey(); 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.18. UnregisterPlaybackKey 
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Function 


UnregisterPlaybackKey 


UnregisterPlaybackKey function unregister color keys 


UnregisterPlaybackKey( ) 


If success, returns positive value 
Return Value 
otherwise, returns negative value 
You can receive only registered keys. 
Remarks Navigation keys are KEY REWIND, KEY STOP, KEY PLAY, 
KEY FE KEY REC, KEY PAUSE 


Emulator 
You can receive all keys without registering key. 
remarks 
function OnLoadFunc() 
{ 
AppCommonPlugin = 
document.getElementB yld(‘PluginAppCommon'’); 
document.getElementB yId(categoryID + '1').focus(); 
Example | F 
AppCommonPlugin.UnregisterNumberKey(): 
AppCommonPlugin.UnregisterNaviKey(): 
AppCommonPlugin.UnregisterColorKey(): 
AppCommonPlugin. UnregisterPlaybackKey(); 


Support from APPCOMMON-0004 
Security Type TVInfo 


4.2.1.19. UnsubscribeEvent 


Function 


UnsubscribeEvent 


UnsubscribeEvent function unregisters message to receive callback 
UnsubscribeEvent( PL APPCOMMON MESSAGE message ) 
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e message 
о РІ, APPCOMMON MESSAGE 
Parameter 
o Message to unregister 
Return If success, returns positive value 
Value otherwise, returns negative value 


Emulator 
none 
remarks 


function OnLoadFunc() 
{ 
document.getElementB yId(categoryID + '1').focus(); 
AppCommonPlugin = document.getElementB yId(‘PluginAppCommon’); 
AppCommonPlugin.SubscribeEvent(PL_APPCOMMON_MESSAGE_INPU 
Т ОССОК); 
AppCommonPlugin.OnMessage = OnMessage; 
Example | function OnUnloadFunc() 
{ 
AppCommonPlugin.UnsubscribeEvent(PL APPCOMMON MESSAGE INP 
UT OCCUR); 
) 
function OnMessage (1d) 
{ 
alert( "OnMessage id=[" + id + "]"); 
switch( parseInt(id) ) 
{ 
case PL APPCOMMON MESSAGE ІМЕ INPUT: 
( 
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ае ((РГ, APPCOMMON MESSAGE IME INPUT": 
document.getElementById('OnMessage').value = "|" + id 
break; 


е PL APPCOMMON MESSAGE 
on 


Support from APPCOMMON-0001 
Security 
TVInfo 
Type 


4.2.2. Enumeration 


4.2.2.1. PL APPCOMMON KEY 


Enumeration 


PL APPCOMMON KEY 


Remarks 


Emulator 


remarks 


29443 - PL APPCOMMON KEY JOYSTICK OK 
262 - PL APPCOMMON KEY MENU 
29460 - PL APPCOMMON KEY JOYSTICK UP 
29461 - PL APPCOMMON KEY JOYSTICK DOWN 
- PL APPCOMMON KEY JOYSTICK LEFT 
osa: - PL APPCOMMON KEY JOYSTICK, RIGHT 

PL APPCOMMON KEY 3 

PL APPCOMMON KEY VOLUP 

PL APPCOMMON KEY 4 

PL APPCOMMON KEY 5 
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- PL APPCOMMON KEY 6 

- PL APPCOMMON KEY VOLDOWN 

- PL APPCOMMON KEY 7 

- PL APPCOMMON KEY 8 

- PL APPCOMMON KEY 9 

- PL APPCOMMON KEY MUTE 

- PL APPCOMMON KEY CHDOWN 

- PL APPCOMMON KEY 0 

- PL APPCOMMON KEY CHUP 
259 - PL APPCOMMON KEY PRECH 
20 - PL APPCOMMON KEY GREEN 
21 - PL APPCOMMON KEY YELLOW 
22 - PL APPCOMMON KEY CYAN 
1023 - PL APPCOMMON KEY STEP 
1024 - PL APPCOMMON KEY DEL 
1025 - PL APPCOMMON KEY ADDDEL 
222 - PL APPCOMMON KEY SOURCE 
77 - PL APPCOMMON KEY TV 
1028 - PL APPCOMMON KEY AUTO 
1029 - PL APPCOMMON KEY MOIP 
1030 - PL APPCOMMON KEY PMENU 
31 - PL APPCOMMON KEY INFO 
1032 - PL APPCOMMON KEY PIP ONOFF 
1033 - PL APPCOMMON KEY PIP SWAP 
1034 - PL APPCOMMON KEY PIP ROTATE 
35 - PL APPCOMMON KEY PLUS100 
1036 - PL APPCOMMON KEY PIP INPUT 
652 - PL APPCOMMON KEY CAPTION 
1038 - PL APPCOMMON KEY PIP STILL 
1039 - PL APPCOMMON KEY AD 
1040 - PL APPCOMMON KEY PMODE 
1041 - PL APPCOMMON KEY SOUND MODE 
1042 - PL APPCOMMON KEY NR 
1043 - PL APPCOMMON KEY SMODE 
650 - PL APPCOMMON KEY TTX MIX 
45 - PL APPCOMMON KEY EXIT 
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1046 - PL APPCOMMON KEY ENTER 

1047 - PL APPCOMMON KEY PIP SIZE 

1048 - PL APPCOMMON KEY MAGIC CHANNEL 
1049 - PL APPCOMMON KEY PIP SCAN 

1050 - PL APPCOMMON KEY PIP CHUP 

1051 - PL APPCOMMON KEY PIP CHDOWN 
1052 - РІ, APPCOMMON KEY DEVICE CONNECT 
1053 - PL APPCOMMON KEY HELP 

1054 - РІ, APPCOMMON KEY ANTENA 

1055 - PL APPCOMMON KEY CONVERGENCE 
73 - PL APPCOMMON KEY 11 

1057 - PL APPCOMMON KEY 12 

1058 - PL APPCOMMON KEY AUTO. PROGRAM 
1059 - PL APPCOMMON KEY FACTORY 

1060 - PL APPCOMMON KEY 3SPEED 

1061 - PL APPCOMMON KEY RSURF 

653 - PL APPCOMMON KEY ASPECT 

1063 - PL APPCOMMON KEY EMANUAL 

1064 - PL APPCOMMON KEY GAME 

1065 - PL APPCOMMON KEY QUICK REPLAY 
1066 - PL APPCOMMON KEY STILL PICTURE 
1067 - PL APPCOMMON KEY DTV 

256 - PL APPCOMMON KEY FAVCH 

69 - PL APPCOMMON KEY REWIND 

70 - PL APPCOMMON KEY STOP 

71 - PL APPCOMMON KEY PLAY 

72 - PL APPCOMMON KEY FF 

192 - PL APPCOMMON KEY REC 

74 - PL APPCOMMON KEY PAUSE 

115 - PL APPCOMMON KEY TOOLS 

1076 - PL APPCOMMON KEY INSTANT REPLAY 
1077 - PL APPCOMMON KEY LINK 

1078 - PL APPCOMMON KEY FF. 

651 - PL APPCOMMON KEY GUIDE 

1080 - PL APPCOMMON KEY REWIND. 

1081 - PL APPCOMMON KEY ANGLE 
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1082 - PL APPCOMMON KEY RESERVEDI 
1083 - РІ, APPCOMMON KEY 7ООМІ 

1084 - PL APPCOMMON KEY PROGRAM 
1085 - PL APPCOMMON KEY BOOKMARK 
1086 - PL APPCOMMON KEY DISC MENU 
1087 - PL APPCOMMON KEY PRINT 

88 - PL APPCOMMON KEY RETURN 

1089 - PL APPCOMMON KEY SUB TITLE 
1090 - PL APPCOMMON KEY CLEAR 

1091 - PL APPCOMMON KEY VCHIP 

78 - PL APPCOMMON KEY REPEAT 

1093 - PL APPCOMMON KEY DOOR 

1094 - PL APPCOMMON KEY OPEN 

29468 - PL APPCOMMON KEY WHEEL LEFT 
76 - PL APPCOMMON KEY POWER 

1097 - PL APPCOMMON KEY SLEEP 

98 - PL APPCOMMON KEY 2 

1099 - PL APPCOMMON KEY DMA 

1100 - PL APPCOMMON KEY TURBO 

101 - PL APPCOMMON KEY 1 

1102 - PL APPCOMMON KEY FM RADIO 
1103 - PL APPCOMMON KEY DVR MENU 
655 - PL APPCOMMON KEY MTS 

1105 - PL APPCOMMON KEY PCMODE 

1106 - PL APPCOMMON KEY TTX SUBFACE 
84 - PL APPCOMMON KEY CH LIST 

108 - PL APPCOMMON KEY RED 

1109 - PL. APPCOMMON KEY DNIe 

654 - PL APPCOMMON KEY SRS 

1111 - PL APPCOMMON KEY CONVERT AUDIO MAINSUB 
1112 - PL APPCOMMON KEY MDC 

1113 - PL APPCOMMON KEY SEFFECT 
1114 - PL APPCOMMON KEY DVR 

1115 - PL APPCOMMON KEY DTV SIGNAL 
1116 - PL APPCOMMON KEY LIVE 

1117 - PL APPCOMMON KEY PERPECT FOCUS 
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1118 - PL APPCOMMON KEY HOME 

1119 - PL APPCOMMON KEY ESAVING 

29469 - PL APPCOMMON KEY WHEEL RIGHT 
261 - PL APPCOMMON KEY CONTENTS 

1122 - PL APPCOMMON KEY VCR MODE 
1123 - PL APPCOMMON KEY CATV MODE 
1124 - PL APPCOMMON KEY DSS MODE 
1125 - PL APPCOMMON KEY TV MODE 

1126 - PL APPCOMMON KEY DVD MODE 
1127 - PL APPCOMMON KEY STB MODE 
1128 - PL APPCOMMON KEY CALLER ID 
1129 - PL APPCOMMON KEY SCALE 

1130 - PL APPCOMMON KEY ZOOM MOVE 
1131 - PL APPCOMMON KEY CLOCK DISPLAY 
1132 - PL APPCOMMON KEY AVI 

1133 - PL APPCOMMON KEY SVIDEOI 

1134 - PL APPCOMMON KEY COMPONENTI 
1135 - PL APPCOMMON KEY SETUP CLOCK TIMER 
1136 - PL APPCOMMON KEY COMPONENT2 
1137 - PL APPCOMMON KEY MAGIC BRIGHT 
1138 - PL APPCOMMON KEY DVI 

1139 - PL APPCOMMON KEY HDMI 

115 - PL APPCOMMON KEY W LINK 

1141 - PL APPCOMMON KEY DTV LINK 

1142 - PL APPCOMMON KEY RESERVED5 

118 - PL APPCOMMON KEY APP LIST 

1144 - PL APPCOMMON KEY BACK MHP 
1145 - PL APPCOMMON KEY ALT MHP 

1146 - PL APPCOMMON KEY DNSe 

147 - PL APPCOMMON KEY RSS 

653 - PL APPCOMMON KEY ENTERTAINMENT 
1149 - PL. APPCOMMON KEY ID INPUT 

1150 - РІ, APPCOMMON KEY ID SETUP 

1151 - PL APPCOMMON KEY ANYNET 

1152 - PL APPCOMMON KEY POWEROFF 
1153 - PL APPCOMMON KEY POWERON 
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1154 - PL АРРСОММОМ KEY ANYVIEW 

1155 - PL APPCOMMON KEY MS 

1156 - PL APPCOMMON KEY MORE 

614 - PL APPCOMMON KEY PANNEL POWER 

105 - PL APPCOMMON KEY PANNEL CHUP 

106 - PL APPCOMMON KEY PANNEL CHDOWN 

203 - РІ, APPCOMMON KEY PANNEL VOLUP 

204 - PL APPCOMMON KEY PANNEL VOLDOWN 

309 - РІ, APPCOMMON KEY PANNEL ENTER 

613 - РІ, APPCOMMON KEY PANNEL MENU 

612 - PL APPCOMMON KEY PANNEL SOURCE 

1165 - PL APPCOMMON KEY AV2 

1166 - PL APPCOMMON KEY AV3 

1167 - PL APPCOMMON KEY SVIDEO2 

1168 - PL APPCOMMON KEY SVIDEO3 

1169 - PL APPCOMMON KEY Z00M2 

1170 - PL APPCOMMON KEY PANORAMA 

1171 - PL APPCOMMON KEY 4 3 

1172 - PL APPCOMMON KEY 16 9 

1173 - PL APPCOMMON KEY DYNAMIC 

1174 - PL APPCOMMON KEY STANDARD 

1175 - PL APPCOMMON KEY MOVIEI 

1176 - PL APPCOMMON KEY CUSTOM 

1177 - PL APPCOMMON KEY AUTO ARC RESET 

1178 - PL APPCOMMON KEY AUTO ARC LNA ON 

1179 - PL APPCOMMON KEY AUTO ARC LNA OFF 
1180 - PL APPCOMMON KEY AUTO ARC ANYNET MODE OK 
1181 - PL APPCOMMON KEY AUTO ARC ANYNET AUTO START 
1182 - PL APPCOMMON KEY AUTO FORMAT 

1183 - PL APPCOMMON KEY DNET 

1184 - РІ, APPCOMMON KEY HDMII 

1185 - PL APPCOMMON KEY AUTO ARC CAPTION ON 
1186 - PL APPCOMMON KEY AUTO ARC CAPTION OFF 
1187 - PL APPCOMMON KEY AUTO ARC PIP DOUBLE 
1188 - PL APPCOMMON KEY AUTO ARC PIP LARGE 
1189 - PL APPCOMMON KEY AUTO ARC PIP SMALL 
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PL APPCOMMON KEY AUTO ARC PIP WIDE 

PL APPCOMMON KEY AUTO ARC PIP LEFT TOP 

PL APPCOMMON KEY AUTO ARC PIP RIGHT TOP 

PL APPCOMMON KEY AUTO ARC PIP LEFT BOTTOM 

PL APPCOMMON KEY AUTO ARC PIP RIGHT BOTTOM 
PL APPCOMMON KEY AUTO. ARC PIP CH CHANGE 

РІ, APPCOMMON KEY AUTO ARC AUTOCOLOR SUCCESS 
PL APPCOMMON KEY AUTO ARC AUTOCOLOR FAIL 

PL APPCOMMON KEY AUTO ARC C FORCE AGING 

PL APPCOMMON KEY AUTO ARC USBJACK INSPECT 

PL APPCOMMON KEY AUTO ARC JACK IDENT 

PL APPCOMMON KEY NINE SEPERATE 

PL APPCOMMON KEY ZOOM IN 

PL APPCOMMON KEY ZOOM OUT 

PL APPCOMMON KEY MIC 

PL APPCOMMON KEY HDMI2 

PL APPCOMMON KEY HDMI3 

PL APPCOMMON KEY AUTO ARC CAPTION KOR 

PL APPCOMMON KEY AUTO ARC CAPTION ENG 

PL APPCOMMON KEY AUTO ARC PIP SOURCE CHANGE 
PL APPCOMMON KEY HDMIA4 

PL APPCOMMON KEY AUTO ARC ANTENNA AIR 

PL APPCOMMON KEY AUTO ARC ANTENNA CABLE 

PL APPCOMMON KEY AUTO ARC ANTENNA SATELLITE 
PL APPCOMMON KEY AUTO ARC CIP TEST 

PL APPCOMMON KEY AUTO ARC CH CHANGE 

PL APPCOMMON KEY AUTO ARC START MBR TEST 

PL APPCOMMON KEY TILT 

PL APPCOMMON KEY EZ VIEW 

PL APPCOMMON KEY 3D 

PL APPCOMMON KEY AUTO ARC PVR RECORDING TEST 
PL APPCOMMON KEY AUTO ARC PVR PLAY TEST 

PL APPCOMMON KEY AUTO ARC PVR DELETE ALL 

PL APPCOMMON KEY AUTO ARC HOTEL INTERACTIVE 
PL APPCOMMON KEY D LIST UP 

PL APPCOMMON KEY D LIST DOWN 
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PL APPCOMMON KEY D ONDEMAND 

PL APPCOMMON KEY D PANNEL VIRTUAL ENTER 
PL APPCOMMON KEY D PANNEL VIRTUAL SOURCE 
PL APPCOMMON KEY D REC PAUSE 

PL APPCOMMON KEY D CONTINUED FF 

PL APPCOMMON KEY D CONTINUED RW 

PL APPCOMMON KEY D CONTINUED OFF 

PL APPCOMMON KEY D CANCEL 

PL APPCOMMON KEY D TITLE MENU 

PL APPCOMMON KEY D REPEAT AB 

PL APPCOMMON KEY D AUDIO 

PL APPCOMMON KEY D REC MODE 

PL APPCOMMON KEY D USB 

PL APPCOMMON KEY D HDD 

PL APPCOMMON KEY D DISC 

PL APPCOMMON KEY D TEST 

PL APPCOMMON KEY D COPY 

PL APPCOMMON KEY D FRONT PLAY 

PL APPCOMMON KEY D FRONT STOP 

PL APPCOMMON KEY D FRONT FF 

PL APPCOMMON KEY D FRONT RW 

PL APPCOMMON KEY D FRONT REC 

PL APPCOMMON KEY D VERSION DISPLAY KEU 
PL APPCOMMON KEY D VIEW MODE 

PL APPCOMMON KEY D COLD START 


4.2.2.2. РІ, APPCOMMON MESSAGE 


Enumeration 


PL APPCOMMON MESSAGE 


none 


Remarks 
Emulator 
none 
remarks 
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SubscribeEvent 


Function UnsubscribeEvent 


PL APPCOMMON MESSAGE APP DEACTIVE 

o When App is deactivated 

PL APPCOMMON MESSAGE APP ACTIVE 

o When App is activated 

PL APPCOMMON MESSAGE APP INITIALIZED 

o Application initialize is done 

PL APPCOMMON MESSAGE START XLET BY APPLIST 
o Ап Xletis started by Application list 

РІ, АРРСОММОМ MESSAGE TIMEZONE CHANGED 

o  Timezone is changed by Menu Application 


PL APPCOMMON MESSAGE XLET SHOW STATE CHANGE 


o When xlet's show state was changed. 
6 - PL APPCOMMON MESSAGE JAM INITIALIZED 
7 - PL APPCOMMON MESSAGE CHANGE TV MODE START 
8 - PL APPCOMMON MESSAGE CHANGE BURNPROOF TIME 
9 


PL APPCOMMON MESSAGE CHANGE DATASERVICE AUTO LAUNCH 
10 - PL APPCOMMON MESSAGE NOTIFY BANNER HIDE 
11 - PL APPCOMMON MESSAGE DATASERVICE PREPARE 
12 - PL APPCOMMON MESSAGE DATASERVICE RECEIVE 
13 - PL APPCOMMON MESSAGE DATASERVICE ERROR 
14 - PL APPCOMMON MESSAGE DATASERVICE HIDE 
15 - PL APPCOMMON MESSAGE POWER ON FROM STANDBY 
o  Aboutto power on from standby mode 
16 - PL APPCOMMON MESSAGE POWER ON BY WAKEUP UPGRADE 
o  Aboutto power on from wakeup upgrade 
17 - PL APPCOMMON MESSAGE POWER ON BY WAKEUP STANDBY 
o  Aboutto power on from wakeup standby 
18 - PL APPCOMMON MESSAGE NOTIFY POWER OFF 
19 - PL APPCOMMON MESSAGE RESET TIME 
o  Occured when TV Viewer received TCTv::EVENT INITIALIZE TIME. 
20 - PL APPCOMMON MESSAGE CHANGE CHILDLOCK 


o  Occured when change Child Lock state 
21 - PL APPCOMMON MESSAGE CHANGE RATING BLOCK 
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o  Occured when rating block state is changed 


22 - PL APPCOMMON MESSAGE CHANGE, AUDIO LANGUAGE 


o  Occured when Audio Language is changed 


23 - PL APPCOMMON MESSAGE INPUT OCCUR 
o  Occured when key is inputed. callback data format is [xxxxxxxx/yyyyyyyy 
x..!MessagelD y..:Key 
РІ, АРРСОММОМ MESSAGE SWD START 
PL APPCOMMON MESSAGE SWD END 
PL APPCOMMON MESSAGE SWD START YES 
PL APPCOMMON MESSAGE SWD START NO 
PL APPCOMMON MESSAGE CC DATA SUBSCRIBE 
PL APPCOMMON MESSAGE CC DATA 
PL APPCOMMON MESSAGE AUTO MOTION DEMO ON 
o Auto Motion Plus 120Hz Demo Start 
- PL APPCOMMON MESSAGE AUTO MOTION DEMO OFF 
o Auto Motion Plus 120Hz Demo Off 
- PL APPCOMMON MESSAGE MOVIE PLUS DEMO ON 


o Movie Plus Demo Start 
- PL APPCOMMON MESSAGE MOVIE PLUS DEMO OFF 
o Movie Plus Demo Off 
- PL APPCOMMON MESSAGE REAL DEMO ON 
o Real Demo Start 
- PL APPCOMMON MESSAGE REAL DEMO OFF 
o Real Demo Off 
PL APPCOMMON MESSAGE LED DEMO ON 
PL APPCOMMON MESSAGE LED DEMO OFF 
PL APPCOMMON MESSAGE SMOOTHMOTION DEMO ON 
PL APPCOMMON MESSAGE SMOOTHMOTION DEMO OFF 
PL APPCOMMON MESSAGE WAKEUP UPGRADE START 
PL APPCOMMON MESSAGE POWER OFF START 
PL APPCOMMON MESSAGE REMIND RECORD 
PL APPCOMMON MESSAGE IME INPUT WAIT START 
PL APPCOMMON MESSAGE IME INPUT WAIT END 
PL APPCOMMON MESSAGE IME INPUT 
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4.2.3. EVENT 


4.2.3.1. OnMessage 


Event 


OnMessage 


Use OnMessage when you receive message(PL APPCOMMON) from AppCommon plugin 


e data 
Paramet о РІ, APPCOMMON MESSAGE 
er о  XXXXXXXX[/yyyy] x.. : MessageID, yyyy : Optional data 


Remarks 


Emulato 
r none 
remarks 


function OnLoadFunc() 
{ 
document.getElementB yId(categoryID + '1').focus(); 
AppCommonPlugin = document.getElementB yId(‘PluginAppCommon’); 
AppCommonPlugin.SubscribeEvent(PL_APPCOMMON_MESSAGE_INPUT 
. OCCUR); 
AppCommonPlugin.OnMessage - OnMessage; 
Example 
function OnUnloadFunc() 
{ 
AppCommonPlugin.UnsubscribeEvent(PL APPCOMMON MESSAGE INPU 
Т ОССОК); 
) 
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function OnMessage (1d) 
{ 


alert( "OnMessage id=[" + id + "]"); 
switch( parseInt(id) ) 
{ 
case PL_APPCOMMON_MESSAGE_IME_INPUT: 
{ 
alert('PL_APPCOMMON_MESSAGE_IME_INPUT'); 
document.getElementById('OnMessage').value = "[" + id + 


break; 


APPCOMMON-0001 


4.3. AUDIO 
4.3.1.Function 

4.3.1.1. CheckExternalOutMode 
Function 


CheckExternalOutMode 


CheckExternalOutMode function check that external out mode can be changed to input value 


Syntax CheckExternalOutMode( PL AUDIO AUDIO OUT MODE audioOutMode ) 


e  audioOutMode 


о РІ AUDIO AUDIO OUT MODE 
o РСМ, DOLBY, DTS, ... 


Return If success, returns 1. 
Value Otherwise, returns a negative number. 
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Remarks 


Emulator 
Only returns PLR NOT IMPLEMENT 
remarks 


var audioOutMode = AudioPlugin.GetExternalOutMode(); 
alert(" AudioPlugin.GetExternalOutMode() = " + audioOutMode); 


Ш audioOutMode == РІ, AUDIO AUDIO OUT MODE PCM ) 
{ 


var checkAudioOutMode = 
AudioPlugin.CheckExternalOutMode(PL AUDIO AUDIO OUT MODE DOLBY) 


3 


alert(" AudioPlugin.CheckExternalOutMode(1) = " + checkAudioOutMode); 


Example 


if( 0 22 checkAudioOutMode ) 
{ 


var result = 
AudioPlugin.SetExternalOutMode(PL AUDIO AUDIO OUT MODE DOLBY); 
alert(" AudioPlugin.SetExternalOutMode(1) =" + result); 


alert(" AudioPlugin.GetOutputDevice() = " + AudioPlugin.GetOutputDevice()); 


PL AUDIO AUDIO OUT MODE 
n 


Support from AUDIO-0011 


Security 
Multimedia 
Type 


4.3.1.2. GetExternalOutMode 


Function 


GetExternalOutMode 


GetExternalOutMode function returns external out mode (PCM, DOLBY, DTS, ... ) 
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Return If success, returns PL AUDIO AUDIO OUT MODE. 
Otherwise, returns a negative number. 


Emulator 
Only returns PLR NOT IMPLEMENT 
remarks 


var audioOutMode = AudioPlugin.GetExternalOutMode(); 
alert(" AudioPlugin.GetExternalOutMode() = " + audioOutMode); 


Ш audioOutMode == PL AUDIO AUDIO OUT MODE PCM ) 
| 
var checkAudioOutMode = 
AudioPlugin.CheckExternalOutMode(PL AUDIO AUDIO OUT MODE DOLBY) 
alert(" AudioPlugin.CheckExternalOutMode(1) = " + checkAudioOutMode); 
Example 
if( 0 == checkAudioOutMode ) 
{ 
var result = 
AudioPlugin.SetExternalOutMode(PL AUDIO AUDIO OUT MODE DOLBY); 
alert(" AudioPlugin.SetExternalOutMode(1) =" + result); 


alert(" AudioPlugin.GetOutputDevice() = " + AudioPlugin.GetOutputDevice()); 


PL AUDIO AUDIO OUT MODE 


Support from AUDIO-0011 


Security 
Multimedia 


4.3.1.3. GetOutputDevice 
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Function 


GetOutputDevice 


Get audio device information which is now using for audio output 


If success, returns PL AUDIO OUTPUT DEVICE 
Return Value 
otherwise, returns error code 


Emulator 
[FAKE] Return value is fixed as PL AUDIO OUTPUT DEVICE MAIN SPEAKER 
remarks 


var outputDevice;. 

outputDevice = AudioPlugin.GetOutputDevice(); 

if( outputDevice == PL AUDIO OUTPUT DEVICE MAIN, SPEAKER ) 

{ 

} 

else if( outputDevice == РІ, AUDIO OUTPUT DEVICE EARPHONE ) 

| 

} 

else if( outputDevice == PL AUDIO OUTPUT DEVICE SUBWOOFER ) 
Example ( 

} 

else if( outputDevice == PL AUDIO ОСТРОТ DEVICE EXTERNAL ) 

{ 

} 

else if( outputDevice == PL_AUDIO_OUTPUT_DEVICE_RECEIVER ) 
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e РІ, AUDIO OUTPUT DEVICE 
Enumeration 


Support from AUDIO-0001 
Security Type Multimedia 


4.3.1.4. GetSystemMute 


Function 
GetSystemMute 


Get information whether systemmute state is on or off. Systemmute means that mute state of DTV platform overall 


If SystemMute On, returns PLR TRUE 
Return Value if System Off, returns PLR FALSE 
if fail to get information, returns a negative number 
If SystemMute is Off, DTV doesn't output any sound whatever UsermMute state is on or off. 
Remarks 
Even though receiver is connected, you cannot bring sound from DTV to receiver. 


Emulator remarks | [FAKE] Get mute information of PC. (same to GetUserMute) 


var systemMute - AudioPlugin.GetSystemMute(); 
if( PLR TRUE == systemMute ) 
{ 
... SystemMute On ... 
) 
else if( PLR FALSE -- systemMute ) 
Example { 
... SystemMute Off ... 
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4.3.1.5. GetUserMute 


Function 
GetUserMute 


Get information of UserMute state of DTV platform. UserMute means that mute state of speaker on DTV only. 


If UserMute On, returns PLR TRUE 
Return Value if UserMute Off, returns PLR FALSE 
if fail to get information of UserMute. Return a negative number. 


UserMute means that mute state of speaker on DTV only. UserMute don't know whether external 
audio output device is used now or not. For example, now receiver is connected and DTV user 

Remarks use audio device as receiver, then GetUserMute cannot get any information of receiver's mute 
state. In this case, you should use GetSystemMute for getting information of receiver's mute 
state. 


Emulator remarks | [FAKE] Get mute information of PC. (same to GetSystemMute) 


var userMute = AudioPlugin.GetUserMute(); 
if( PLR TRUE == userMute ) 
{ 
... UserMute On ... 
) 
else if( РІВ FALSE == userMute ) 
Example ( 
... UserMute Off ... 
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4.3.1.6. GetVolume 


Function 
Get Volume 


Get volume level on DTV platform. The range of volume is 0 - 100 


If success, returns a value between 0 and 100 as a volume level. 
Return Value . . 
otherwise returns a negative number. 


Emulator remarks | [FAKE] Get volume information of PC, and calculate PC's volume range is 0-100. 


var volume; 

volume - AudioPlugin.GetVolume(); 
Example 

alert(volume); 


Support from AUDIO-0001 


4.3.1.7. IsActiveSourceOnCEC 


Function 
IsActiveSourceOnCEC 


Get information whether now HDMI-CEC device is active or not on DTV platform 


IsActiveSourceOnCEC ( ) 


If HDMI-CEC device is active, returns PLR TRUE 
Return Value 
If HDMI-CEC device is not active or connected, returns PLR FALSE. 
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Hr If fail to get information, returns a negative number 


Emulator 


[FAKE] Always returns PLR FALSE 


remarks 


if( PLR TRUE == AudioPlugin.IsActiveSourceOnCEC() ) 
{ 
Example AudioPlugin.SetTVSourceOnCEC): 


Support from AUDIO-0004 
Security Type 


4.3.1.8. SetExternalOutMode 


Function 
SetExternalOutMode 


SetExternalOutMode function sets external out mode (PCM, DOLBY, DTS, ... ) 


SetExternalOutMode( PL AUDIO AUDIO OUT MODE audioOutMode ) 


e  audioOutMode 
o PL AUDIO AUDIO OUT MODE 
Parameter 
о РСМ, DOLBY, DTS, ... 


Return If success, returns 1. 


Value Otherwise, returns a negative number. 


Remarks 


Emulator 


Only returns PLR_NOT_IMPLEMENT. 
remarks 


var audioOutMode = AudioPlugin.GetExternalOutMode(); 
alert(" AudioPlugin.GetExternalOutMode() = " + audioOutMode); 
Example . . 
Ш audioOutMode == PL AUDIO AUDIO OUT MODE PCM ) 
{ 
var checkAudioOutMode = 
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AudioPlugin.CheckExternalOutMode(PL AUDIO AUDIO OUT MODE DOLBY) 


’ 


alert(" AudioPlugin.CheckExternalOutMode(1) =" + checkAudioOutMode); 
if( 0 22 checkAudioOutMode ) 


{ 


var result = 
AudioPlugin.SetExternalOutMode(PL AUDIO AUDIO OUT MODE DOLBY); 
alert(" AudioPlugin.SetExternalOutMode(1) =" + result); 


alert(" AudioPlugin.GetOutputDevice() = " + AudioPlugin.GetOutputDevice()); 


Enumeratio . PL AUDIO AUDIO OUT MODE 


n 
Support from AUDIO-0011 


Security 
Multimedia 
Type 


4.3.1.9. SetSystemMute 


Function 


SetSystemMute 


Set state of SystemMute in DTV platform. 


SetSystemMute( PLBOOL  systemMute ) 


e  systemMute 
o PLBOOL 
Parameter o РІК ТЕГЕ: set state as SystemMute 
PLR FALSE :set state as non-SystemMute 


Return Value If success, returns PLR TRUE, otherwise returns a negative number. 


If SystemMute is Off, DTV doesn't output any sound whatever UsermMute state is on or off 


Remarks 
Even though receiver is connected, you cannot bring sound from DTV to receiver. 


[FAKE] Set PC's mute state 
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ете |00000 O 


AudioPlugin.SetSystemMute(PLR, TRUE); 
Example AudioPlugin.SetSystemMute(PLR, FALSE); 


Support from AUDIO-0005 
Security Type 


4.3.1.10. SetTVSourceOnCEC 


Function 
SetTVSourceOnCEC 


Change TV's source to TV signal itself from CEC source. 


SetTVSourceOnCEC ( ) 
If success, returns PLR TRUE 
Return Value 
otherwise returns a negative number. 


Emulator 
[FAKE] do not any action, and always returns PLR TRUE 
remarks 


if( PLR TRUE == AudioPlugin.IsActiveSourceOnCEC() ) 
{ 
Example AudioPlugin.SetTVSourceOnCEC(); 


Only returns false. 
Support from AUDIO-0004 
Security Туре 


4.3.1.11. SetUserMute 


Function 


SetUserMute 
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Set state of UserMute in ОТУ platform. 


SetUserMute( PLBOOL userMute ) 


е  userMute 
o PLBOOL 
Parameter o PLR TRUE: set as UserMute 
PLR FALSE: set as non-UserMute 


If success, returns PLR TRUE 
Return Value | . 
otherwise, returns a negative number. 


Remarks 


Emulator 
[FAKE] set mute state of PC 
remarks 


AudioPlugin.SetUserMute(PLR, TRUE); 
Example AudioPlugin.SetUserMute(PLR, FALSE); 


Support from AUDIO-0005 
Security Type 


4.3.1.12. SetVolumeWithKey 


Function 
SetVolumeWithKey 


Increment(+1) or decrement(-1) volume level depending on key. 


SetVolumeWithKey( PL AUDIO VOLUME KEY key) 


PL AUDIO VOLUME KEY 
Parameter PL AUDIO VOLUME KEY UP: increment volume level 
PL AUDIO VOLUME KEY. DOWN : decrement volume level 


If success, returns PLR, TRUE. 
Return Value . : 
Otherwise, returns a negative number. 


[FAKE] Do nothing, just print out function name on debug console in SDK. 
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remarks | O 


AudioPlugin.SetVolumeWithKey(PL AUDIO VOLUME KEY UP): 
Example AudioPlugin.SetVolumeWithKey(PL AUDIO VOLUME KEY DOWN); 


е PL AUDIO VOLUME KEY 
Enumeration 


Support from AUDIO-0002 
Security Type | Multimedia 


4.3.2. Enumeration 
4.3.2.1. PL AUDIO AUDIO OUT MODE 
Enumeration 


PL AUDIO AUDIO OUT MODE 


none 


Remarks 


Emulator 
none 
remarks 
e  GetExternalOutMode 


CheckExternalOutMode 
SetExternalOutMode 


0 - PL AUDIO AUDIO OUT MODE PCM 
Value 1 - PL AUDIO AUDIO OUT MODE DOLBY 
u 
2 - PL AUDIO AUDIO OUT MODE DTS 


4.3.2.2. PL AUDIO OUTPUT DEVICE 


Function 


Enumeration 


PL AUDIO OUTPUT DEVICE 


none 


Remarks none 
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Emulator 
none 
remarks 
GetOutputDevice 
Function 


- PL AUDIO OUTPUT DEVICE MAIN SPEAKER 
o Маш speaker 
PL AUDIO OUTPUT DEVICE EARPHONE 
o  Earphone 
PL AUDIO OUTPUT DEVICE SUBWOOFER 
Value o Subwoofer 
PL AUDIO OUTPUT DEVICE EXTERNAL 
o External speaker ex)Component audio, Composite audio 
PL AUDIO OUTPUT DEVICE RECEIVER 
o receiver ex)HDMI, SPDIF 


4.3.2.3. PL AUDIO VOLUME KEY 


Enumeration 
PL AUDIO VOLUME KEY 


none 


Remarks 


Emulator 


remarks 


е SetVolumeWithKey 
Function 


e 0 - PL AUDIO VOLUME KEY UP 


o Volume +1 
e 1- PL AUDIO VOLUME KEY DOWN 


o Volume -1 
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4.4. DEVICE 
4.4.1.Function 


4.4.1.1. GetDisplayPanelType 


Function 


GetDisplayPanelType (Replaced) 


Returns panel type of current DTV. 


If success, returns PL. DEVICE DPT(DisplayPanelType). (see example for detail) 
Return Value 
otherwise, return error code. 


This function is replaced same name function of TV plugin 


Emulator 
[FAKE] always returns PL DEVICE DPT LCD 
remarks 


displayPanelType - DevicePlugin.GetRealModel(); 
switch( displayPanelType ) 
{ 
case PL_DEVICE_DPT_LCD: 
break; 
case PL DEVICE DPT PDP: 
break: 
case PL DEVICE DPT DLP: 
Example 
break: 
case PL DEVICE DPT LED: 
break: 
case PL DEVICE DPT LED EDGE: 
break: 
case PL DEVICE DPT LED DIRECT: 
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break: 
case PL DEVICE DPT CRT: 
break: 
case PL DEVICE DPT UNKNOWN: 


break: 


default: 
displayPanelType = "ERROR"; 


: e ІРІ, DEVICE ОРТ 
Enumeration 


Support from DEVICE-0001 
Security Type TVInfo 


4.4.1.2. GetModel 


Function 
GetMedel (Replaced) 


Returns mode code which is modified for Samsung Smart TV 


If success, returns modified model code. 
Return Value . 
Otherwise, returns error code. 


This function is replaced GetModelCode function of NNavi plugin 

Remarks Modified model code is the same as real model code, except that panel size number is replaced 
with XX (refer to GetRealModel()) 
ex) LNXXB650 KOR 


Emulator remarks | [Fake] Returns LNXXB650 KOR 


DevicePlugin.GetModel(); 


Example 
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Support from DEVICE-0001 


Security Type TVInfo 


4.4.1.3. GetRealModel 


Function 
GetRealMedel (Replaced) 


Returns model code of DTV with region string. 


If success, return real model code 
Return Value : 
Otherwise, returns error code. 


This function is replaced GetProductCode function of TV plugin 
Remarks 
Real model code - [model code] [region code] 
ex) LNA0B650 KOR 
Emulator remarks | [Fake] Returns LNXXB650 KOR 


ETE DevicePlugin.GetRealModel(); 
Example 


"тан | 
Support from DEVICE-0002 
Security Type TVInfo 


4.4.2. Enumeration 
4.4.2.1. PL DEVICE DPT 
Enumeration 


PE-DEVICE-DPT (Replaced) 


none 


Remarks 


Emulator 


remarks 
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i GetDisplayPanelType (Repl 
| | Sun 


PL DEVICE DPT LCD 
o LCD 
PL DEVICE DPT PDP 
o PDP 
PL DEVICE DPT DLP: 
o DLP 
PL DEVICE DPT LED 
o LED 
Value PL DEVICE DPT LED EDGE 
o LED EDGE 
PL DEVICE DPT LED DIRECT 
o LED DIRECT 
PL DEVICE DPT CRT 
o CRT 
PL DEVICE DPT UNKNOWN 
o UNKNOWN 


4.5. Download 


4.5.1.Function 


4.5.1.1. CancelDownload 


Function 
CancelDownload 
Cancel download task. This function works asynchronously, so when cancel is completed, an event is sent to the widget. 


(see OnComplete() for details of the event) 


Return value of this functions is not the result of cancelling download. To check whether 


Remarks 
cancelling of download is completed or not, check the callback OnComplete(). 
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E 
DownloadPlugin.CancelDownload(): 


Support from DOWNLOAD-0001 
Security Type 


4.5.1.2. CancelUpload 


Function 


CancelUpload 


Cancel Upload task. so when cancel is completed, an event is sent to the widget. (see OnUploadComplete() for details 


of the event) 


Function 


CheckDownloadSpeed 


Check Download Speed. (see OnComplete() for details of the event) 


CheckDownloadSpeed( String SrcURL , Number FileSize , Number DownGap ) 


е  SrcURL 
o String 
Parameter o Source url to download (URL can start with http or https 
е FileSize 
o Number 
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o Total file size to download. Used as basis for calculating download progress 
ratio. (If http server sends the content size, then this parameter is ignored, and 
received contents size is used instead. 

e DownGap 

o Number 

o Тһе gap(%) for notification - meaning when SpeedCheck progress increases by 
the gap amount, this module notifies the current Speedcheck progress to the 
widget. For example, if the widget sets this parameter to 10, then the widget 
will be notified with a progress event when SpeedCheck progress is 10%, 20%, 

., 90%, 100%. 


Return Value 


Emulator 
Not supported 
remarks 


// for file download speed testing 
" i DownloadPlugin.CheckDownloadSpeed( http:// 
хатріе 
4 testHttpServer//files/widget/W idgetDnTest.zip', 10000, 10 ); 


Support Нот DOWNLOAD-0003 
Security Type 


4.5.1.4. StartDownFile 


Function 
StartDownFile 
Request to start download throughout http or https. This function is asynchronous, download progress and state are 
notified to widget as events. (see OnComplete() for details of events) 
StartDownFile( String SrcURL , String DestURL , Number FileSize , Number DownGap ) 
е SrIcURL 


o String 


Parameter o Source url to download (URL can start with http or https 


e DestURL 


o String 
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o Destination on DTV to be downloaded. If this url is only “??”, then do not download 
on DTV storage, but calculate download speed and notify it to widget. 
е FileSize 
o Number 
o Total file size to download. Used as basis for calculating download progress ratio. (If 
http server sends the content size, then this parameter is ignored, and received 
contents size is used instead. 
е DownGap 
o Number 
o The gap(%) for notification - meaning when download progress increases by the gap 
amount, this module notifies the current download progress to the widget. For 
example, if the widget sets this parameter to 10, then the widget will be notified with 
a progress event when download progress is 10%, 20%, ..., 90%, 100%. 


Return 
not used 
Value 


Remarks 


Not supported 

remarks 
// for file downloading 
DownloadPlugin.StartDownFile(‘http://testHttpServer//files/widget/WidgetDnTest.zip 
', /dtv_root/TempDownLoad/WidgetDnTest.zip', 10000, 10 ); 

Example | // for file download speed testing 
DownloadPlugin.StartDownFile(‘http:// 
testHttpServer//files/widget/WidgetDnTest.zip’, 27, 10000, 10); 


Enumeratio 
none 


Support Нот DOWNLOAD-0001 
Security 
System 
Type 


4.5.1.5. StartUpload 
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Function 


StartUpload 


Request to start upload. Upload progress and state are notified to widget as events. (see 


OnUploadComplete(),OnUploadProgress() for details of events) 
StartUpload( String Server , Number Port , String Header , String Body , String FilePath , 
String UploadRatio , Number ServerType ) 
Server 
String 


the server URL where file is upload at 


Number 


It's target server port for uploading 


String 
Header String of Upload Message Format 


Parameter мша 
o Тһе body of the upload format. 
FilePath 
o String 
o the file path which have uploaded file. 
UploadRatio 
o String 
o This Ratio decide How often the progress of upload is showed. 
ServerType 
o Number 


o deliver the different result which server returned to widgets by this server type. 


Return Value the result success or fail 


Emulator 
Not supported 
remarks 


// for file Upload 
function OnUploadComplete(msg) 
Example | 
alert(***OnUploadComplete***' + msg ); 
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function OnUploadProgress(msg) 

{ 
alert(***OnUploadProgress***' + msg ); 

function OnLoadFunc() 

{ 
DownloadPlugin = document.getElementB yld(‘pluiginObject’); 
DownloadPlugin.OnUploadComplete=OnUploadComplete; 
DownloadPlugin.OnUploadProgress=OnUploadProgress; 
DownloadPlugin.StartUpload('10.88.76.42',1317,'111The Herder 

Message by Thread SendEvent...\n','The body Message by 

[[[FILE_BINARY]]]Thread 

SendEvent..n', SUSB. DIR/sdal/UploadTest/UploadTest.txt', 10,1); 
document.getElementB yId(categoryID + '1').focus(); 


Support from DOWNLOAD-0007 
Security Type 


4.5.2. Enumeration 


4.5.2.1. PL DN ST 
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Enumeration 
PL DN ST 


none 


Emulator 


remarks 


0 - PL DN ST PREPARED 
- PL DN ST DOWNLOADING 
- PL DN ST FINISH 
Value 
- PL DN ST IDLE 
PL DN ST UNKNOWN 


4.5.2.2. PL DOWNLOAD UPLOAD SERVER TYPE 


Enumeration 
РІ, DOWNLOAD UPLOAD SERVER TSERVER TYPE 


none 


Emulator 
Not supported 
remarks 


EC | 
e 0 - PL DOWNLOAD UPLOAD SERVER TYPE SIMPLE RESULT 
Value е 1- PL DOWNLOAD UPLOAD SERVER TYPE HTTP PICASA 


4.5.3. EVENT 


4.5.3.1. OnComplete 


Event 


OnComplete 


Callback function of download result. 
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Parameter is consist of 2 fields, and each fields is separated with ‘?’. 

If first field is “1000”, this event tells the widget that download is complete. If the second field 1$ ‘1’, download 
completed with no error, otherwise with an error. 

If first field 1$ “1001”, this event tells the widget the percentage progress of the download. The second field gives the 
current download percentage. 

If first field is “1002”, this event tells the widget the download speed. The second field is the download speed 
(bytes/sec). 


See example for detail. 


e  DownloadStatus 
o String 
Parameter 
о 100071 


Remarks 


Emulator 
Not supported 
remarks 


// register 
function OnLoadFunc() 
{ 
DownloadPlugin = document.embeds[0]: 
DownloadPlugin.OnComplete = fnDnStatus; // register OnComplete 
function callback as fnDnStatus 
) 
И actual function 
Example function fnDnStatus(msg) 
{ 
alert('fnCallback' + msg ); 
var tArrResult = msg.split("?"); 
for (var 1=0 ; i«tArrResult.length ; i++) { 
alert("tArrResult[" +i + "| =" tArResult[i]): 
И DownResult : If res=1 success, otherwise ERROR (see end of this file) 
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if (tArrResult[0]==1000 ) 
{ 
document.getElementB yId('DownResult').value = 

tArrResult[ 1]; 

) 

// DownRatio : 0-100 

else if (tArrResult[0]==1001 ) 

{ 


document.getElementBylId('DownloadedRatio').value = tArrResult[1]; 


} 
// Down Speed : Bytes/Sec : It will be reach after Ratio 


else if (tArrResult[0]==1002 ) 


{ 
document.getElementById('DownSpeed').value = tArrResult[ 1]: 


4.5.3.2. OnUploadComplete 


Event 

OnUploadComplete 

Callback function of Upload result. 

Parameter is consist of 2 fields, and each fields is separated with ‘?’. 

If Upload is success the first field 15 set “201”, this event tells the widget that Upload is complete successfully. And The 
2nd field is set to the body of ServerReturnMessage. this Two field is devided by "?" 

If Upload is fail, just one filed is set to minus value. 

If first field is “O”,it means that User Cancele Upload. 

If first field is “-1”,It means that Socket creating is fail. 

If first field is “-2”, It means that you fail to get host URL. 


If first field is “-3”,It means that you fail to have connection to server 


If first field is “-4”,It means that you fail to Send Uplad Message sucessfully. 


If first field is “-5”,It means that You fail to Recieve return message from server in 30 sec. 


If first filed is -6, It meams that You have Internal errors like the Failure of Reading File. 
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See example for detail. 


е DownloadStatus 
o String 
Parameter 
o 201?The Body Part of Return Message 


Remarks 


Emulator 
Not supported 
remarks 


function OnUploadComplete(msg) 

{ 
alert(***OnUploadComplete***' + msg ): 

function OnUploadProgress(msg) 

{ 
alert(***OnUploadProgress***' + msg ); 

Example 

function OnLoadFunc() 

{ 
DownloadPlugin = document.getElementB yId(‘pluiginObject’); 
DownloadPlugin.OnUploadComplete=OnUploadComplete; 
DownloadPlugin.OnUploadProgress=OnUploadProgress; 
DownloadPlugin.StartUpload('10.88.76.42',1317,'111The Herder Message 

by Thread SendEvent...\n’,"The body Message by [[[FILE_BINARY]]]Thread 

SendEvent...1n', SUSB  DIR/sdal/UploadTest/UploadTest.txt', 10,1); 
document.getElementB yId(categoryID + '1').focus(); 
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DOWNLOAD-0007 


4.5.3.3. OnUploadProgress 


Event 


OnUploadProgress 


Callback function of Upload result. This Event show the percentage of Upload Progress. 


e UploadProgressRatio 
o String 
Parameter 
о 


Emulator 
Not supported 
remarks 


function OnUploadComplete(msg) 

{ 
alert( ***OnUploadComplete***' + msg ); 

function OnUploadProgress(msg) 

| 

Example alert( ***OnUploadProgress***' + msg ); 

function OnLoadFunc() 

{ 
DownloadPlugin = document.getElementB yld(‘pluiginObject’); 
DownloadPlugin.OnUploadComplete=OnUploadComplete; 
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DownloadPlugin.OnUploadProgress=OnUploadProgress; 


DownloadPlugin.StartUpload('10.88.76.42',1317,'111The Herder Message 
by Thread SendEvent...\n’,"The body Message by [[[FILE BINARY ]]]Thread 
SendEvent...1n', SUSB DIR/sdal/UploadTest/UploadTest.txt', 10,1); 


document.getElementB yId(categoryID + '1').focus(); 


DOWNLOAD-0005 


4.6. ExternalWidgetInterface 
4.6.1. Function 

4.6.1.1. AccountRead 
Function 


AccountRead 


Read account data from SecureStorage 


if success returns string from SecureStorage, 
Return Value NULL string in case of error, 
PLR_FAIL if this function is not allowed for the widget 


Restricted to use by WidgetManager ONLY 


var data = plugin. AccountRead(), 
Example alert ("data=" + data); 


Support from EXTERNALWIDGETINTERFACE-0003 
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4.6.1.2. AccountRemove 


Function 


AccountRemove 


Removes account data from SecureStorage 


PLR TRUE if data successfully removed, 
Return Value 
PLR FALSE in case of error, 
PLR FAIL if this function is not allowed for the widget 


Restricted to use by WidgetManager ONLY 


alert(" AccountRemove = " + plugin. AccountRemove()): 
Example 


Support from EXTERNALWIDGETINTERFACE-0003 


4.6.1.3. Account Write 


Function 
AccountWrite 


Writes account data to SecureStorage 


AccountWrite( String dataString ) 


e  dataString 


o String 
Parameter 


o [Input data to be written 


PLR, TRUE if data successfully written, 


Return Value 
РІК FALSE in case of error, 


PLR FAIL if this function is not allowed for the widget 


Restricted to use by WidgetManager ONLY 
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var data = "\ 
«encode type = UTF-8>\n\ 
<body>\n\ 
<company> \n\ 
<name> Netflix </name>\n\ 
<id> myID </id>\n\ 
<pw> 1234 </pw>\n\ 
</company>\n\ 


<company> \n\ 
<name> YouTube </name>\n\ 
Example <id> myID2 </id>\n\ 
<pw> 12345 </pw>\n\ 


</company>\n\ 

<company> \n\ 
<name> E-Bay </name>\n\ 
<id> myID3 </id>\n\ 
<pw> 123456 </pw>\n\ 

</company>\n\ 

</body>"; 


alert(" AccountWrite =" + plugin. AccountWrite(data)): 


Support from EXTERNALWIDGETINTERFACE-0003 


4.6.1.4. GetESN 


Function 


GetESN 


GetESN string for needed service 
GetESN( | GetESN( String widgeiName) ООО widgetName ) 
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е  widgetName 
o String 
Parameter 
о Мате of the widget(ex. NFLX) 


ESN string (success), 
Return Value 
null string (error) 


| еше), 000000000000. 


Emulator 


remarks 


Ёё i document.getElementBylId('esn').value = 
xample | 
ExternalWidgetInterface.GetESN("NFLX"); 


Support from EXTERNALWIDGETINTERFACE-0003 
Security Type 


4.6.1.5. IsBound 


Function 


IsBound 


Checks the activation status of the widget 


IsBound( String widgetName ) 


е widgetName 
о String 
o Name of the widget(ex. NFLX) 


Parameter 


PLR_TRUE if widget is activated, 
Return Value 
PLR_FALSE if it is not activated 


| еше), 000000000000. 


Emulator 


Only returns false. 


remarks 


alert (‘IsBound(NFLX) = ' + ExternalWidgetInterface.IsBound(" NFLX"); 


Support from EXTERNALWIDGETINTERFACE-0003 
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4.6.1.6. UnBind Widget 


Function 
UnBindWidget 


Deactivate specific widget 


UnBindWidget( String widgetName ) 


e widgetName 
o String 
Parameter 
o Мате of the widget(ex. NFLX) 


PLR, TRUE(deacitvated successfully), 
PLR, FALSE otherwise 


| Remarks || 


Emulator 


Return Value 


Olny returs falses. 
remarks 


Е | alert 'UnBindWidget(NFLX) =' + 
хатріе 
? ExternalWidgetInterface. UnBindWidget("NFLX")); 


Support from EXTERNALWIDGETINTERFACE-0003 
Security Туре 


4.7. FileSystem 


4.7.1.Function 


4.7.1.1. IsExistedPath 


Function 


IsExistedPath 


Returns whether designated path exists or not. 
IsExistedPath( String path ) 
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е path 
Stri 
Parameter o bs 
o Path to check whether the path exists or not 
If exists, returns PLR TRUE. 
Return Value If does not exist, returns PLR FALSE. 
If check fails, returns error code. 


Emulator 
none 
remarks 
var CopyPath = '/dtv_root/test/srcCopy/GirlsGeneration.zip’; 
var result = FileSystemPlugin.IsExistedPath(CopyPath); 
ІК result == РІК TRUE) 
{ 
.. EXISTED .. 
) 
else if (result == PLR FALSE) 
Example { 
.. МОТ EXISTED .. 
} 


else 


{ 
.. ERROR .. 


Support from FILESYSTEM-0001 
Security Type 
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4.8. FrontPanel 
4.8.1.Function 


4.8.1.1. DisplayVFD Show 


Function 
DisplayVFD Show 


SHOW the TEXT on VFD 


DisplayVFD Show( NUMBER ста) 


NUMBER 
Parameter 
Command 


Return Value always return true. 


insert instead of Parameter NUMBER 
FRONT DISPLAY PLAY 0100 
FRONT DISPLAY STOP 0101 
Remarks 
FRONT DISPLAY PAUSE 0102 
FRONT DISPLAY ONLINE 0200 
then, Show the PLAY, STOP, PAUSE or ONLINE text on VFD 


Emulator 
none 
remarks 
FrontPanelPlugin.DisplayVFD Show(FRONT DISPLAY PLAY); 
xample 


Support from FRONTPANEL-0001 
Security Type 


4.8.1.2. DisplayVFD Time 


Function 


DisplayVFD Time 


Show the Play-Time 


DisplayVFD Time( NUMBER hour, NUMBER minutes, NUMBER seconds ) 
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NUMBER 
o hour 
e minutes 
Parameter о NUMBER 
о minutes 
e seconds 
o NUMBER 
o seconds 


Return Value always return true. 


Emulator 
none 
remarks 
m FrontPanelPlugin.DIsplayVFD_Time(1,15,50); 
Example 


Support from FRONTPANEL-0001 
Security Type 


4.9. IME 
4.9.1. Function 


4.9.1.1. DelnitIME 


Function 


DelnitIME 


Delnit IME 
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Not supported by emulator 
IMEPlugin.DeInitIME(): 


Support from IME-0002 
Security Type 


4.9.1.2. DeInitMyWordIME 


Function 


DelnitMyWordIME 


кыв ОИ 
| каш |) 002502000000 


4.9.1.3. GetActiveWordPosition 


Function 


Get ActiveWordPosition 


Get beginning and end position of active word 
Get ActiveWordPosition( ) 


"ыма ООО 
Пие О 
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4.9.1.4. GetCharacterList 


Function 
GetCharacterList 


Get character list in ABC mode 


GetCharacterList( Number keycode ) 


e keycode 
o Number 
Parameter 
o  Keycode(ascii code, key 1->49, key 2->50,...) 


Return Value Character list in ABC mode, Return -1 if failed. 
| Remarks | 


Emulator 
Not supported by emulator 
remarks 


4.9.1.5. GetCursorPosition 


Function 
GetCursorPosition 


Get the position of the cursor in the text buffer 
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Example 


Enumeration none 
Version Support from IME-0002 


Security Type Multimedia 


4.9.1.6. GetIMEInputMode 


Function 
GetIMEInputMode 


Get current input mode 


GetIMEInputMode( ) 


Modetype (MODE MENU-1, MODE HELP-2, MODE SYMBOL-3, MODE 123-4, 
Return Value 
MODE, ABC-5, MODE T9-6) 


Emulator remarks | Not supported by emulator 


var IMEInputMode = IMEPlugin.GetIMEInputMode(); 
Example alert IMEInputMode = '  IMEInputMode); 


Support from IME-0002 


4.9.1.7. GetLanguage 


Function 
GetLanguage 


Get current language 


GetLanguage( ) 


none 


LanguageCode, such as EN, FR, DE etc. See language code document for details. Return -1 if 
failed. 


Return Value 
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Emulator remarks | Not supported by emulator 


var lang = IMEPlugin.GetLanguage(); 
Example alert(‘lang = ' + lang); 


Support from IME-0002 


4.9.1.8. GetRecommendedString 


Function 
GetRecommendedString 


Get RecommendedString that will be displayed on screen 


"ымы ООО 
ELTE ОИ 


4.9.1.9. GetRecommendedStringCount 


Function 


GetRecommendedStringCount 


Get the amount of recommended string 
GetRecommendedStringCount( ) 


мю [ 
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Support from IME-0002 
Security Type 


4.9.1.10. GetShfCapState 


Function 


GetShfCapState 


ar г 
Support from IME-0002 


4.9.1.11. GetString 


Function 


GetString 


Get strings that will be displayed on screen 


Ою an 
"aaa 
Support from IME-0002 
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Security Type 


4.9.1.12. InitIME 


Function 
InitIME 


Initialize IME System 


InputKey ( Number maxBufLen ) 


е maxBufLen 
o Number 
Parameter 
o Max Buffer Length 


4.9.1.13. InitMyWordIME 


Function 
InitMyWordIME 


Init My Word Page 
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Security Type 


4.9.1.14. InputKey 


Function 


InputKey 


Handle pressed key and submit keycode to IME core 


InputKey( Number keycode ) 


e keycode 
o Number 


Parameter 
o  Keycode(ascii code, key 1-549, key 2-550,...) 


Emulator 
Not supported by emulator 
remarks 


4.9.1.15. ResetUDBData 


Function 
ResetUDBData 


Reset UDB to empty 
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Support from IME-0002 


Security Type 


4.9.1.16. SetCursorPositon 


Function 
SetCursorPositon 


Set Cursor Position in Text Buffer 


SetCursorPositon( Number nCount ) 


e  nCount 
o Number 
Parameter 
o Cursor Position which will be set to text buffer 


"нән О 
н 


4.9.1.17. SetIMEInputMode 


Function 
SetIMEInputMode 


Set current input mode 


SetIMEInputMode( Number ModeType ) 


e  ModeType 


o Number 
Parameter o MODE MENU-I1, MODE HELP-2, MODE SYMBOL-3, MODE 123-4, 
MODE АВС-5, MODE Т9-6 
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Default is MODE T9, if you want to set your own default mode, you must call 
IMEPlugin.SetIMEInputMode(i) in webpage OnLoadFunc() 

Remarks 
If you want to input strings like “a2” or “ab2” in ABC mode (characters on the same button), you 
must press right key (call InputKey(82) ) after inputting one character. Or set a timer by ОТ, after 
timer is reached, call InputKey(82) automatically. 


Emulator 
Not supported by emulator 
remarks 


4.9.1.18. SetLanguage 


Function 
SetLanguage 


Set current language 


SetLanguage( String LanguageCode ) 


е  LanguageCode 
o String 
Parameter o  LanguageCode, such as EN, ЕК, DE etc. See language code document for 


details. 


Return Value 1 success 0 failed 
| Remarks О 


Emulator 


Not supported by emulator 
remarks 


IMEPlugin.SetLanguage(" EN"); 
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4.9.1.19. SetString 


Function 


SetString 


Set strings that will be displayed on screen 


SetString( String str ) 


String 
Parameter 
Strings which will be set to text buffer 


Сю 


4.10.Image Viewer 
4.10.1. Function 


4.10.1.1. ClearScreen 


Function 
ClearScreen 


This ClearScreen() erases TV screen with black. 


Return Value _. ka 
It returns ture if it succeeds, otherwise it returns false. 
Emulator 
none 
remarks 
var retV al=ImageViewer.CleerScreen() 
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Support from IMAGEVIEWER-0001 


4.10.1.2. GetVideoHeight 


Function 
Get VideoHeight 


GetVideoHeight() function retrieves height of currently playing video. 


Return Value 

GetVideoHeight returns the height size of currently playing video content. 
Remarks 

This GetVideoHeight() API has be called after OnStreamInfoReady callback function is called. 
Emulator 

none 
remarks 

var widthzImageViewer.GetVideoHeight(); 

Example 


Support from IMAGEVIEWER-0001 


4.10.1.3. GetVideoWidth 


Function 


Get VideoWidth 


GetVideoWidth() function retrieves width of image 


Parameter 


Return Value 


GetVideoWidth returns the width size of image. 


| Remarks |) | 


@Samsung Electronics Copyright АП Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


KH This GetVideoWidth() API has be called after OnStreamInfoReady callback function is called. 
Emulator 
none 
remarks 
var width=Image Viewer.GetVideoW idth(): 
Example 


Support from IMAGEVIEWER-0001 
Security Type 


4.10.1.4. InitPlayer 


Function 
InitPlayer 


Initialize image viewer with the specified url. 


InitPlayer( String url ) 


String 
Parameter 
Specifies the URL of content to play 


Return Value 
It always returns ture. 


The InitPlayer() should not be used with Play() API. 

Remarks If widget uses InitPlayer(), it has to use StartPlayback() to play a content. 
Otherwidget it has to use Play() only. 
When InitPlayer() is used, it has to come first becore other APIs are called. 


Emulator 


remarks 


InitPlayer(url); 
SetDisplayArea(x, y, width, height); 
Example SetInitialBufferSize(400* 1024); 
//400KB 
StartPlayback(): 
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none 


Support from IMAGEVIEWER-0001 


Multimedia 


4.10.1.5. Ріау 


Function 
Play 


Starts playing a content specified by url. 


String 
Parameter 
Specifies the URL of content 


Return Value : | | io 
The return value is true if media player succeed to start play, otherwise it returns false. 


ETE var retVal=ImageViewer.Play(url); 
Example 


Support from IMAGEVIEWER-0001 
Security Type 


4.10.1.6. SetDisplayArea 


Function 
SetDisplayArea 


SetDisplay Агеа() sets the display area for video content in TV screen. 


SetDisplayArea( Number x,Number y,Number width, Number height ) 


Parameter 
Number 
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Specifies the initial x-coordinate of display area in TV screen coordinates. 
This x value must be smaller than TV screen width, 960. 

Number 

Specifies the initial y-coordinate of display area in TV screen coordinates. 
This y value must be smaller than TV screen height, 540. 

Number 

The width of display area. 

This value must be smaller than width of TV screen. 

The height of crop area from source Image. 

This value must be smaller than height of source image. 


Return Value t E 
It returns ture if it succeeds, otherwise it returns false. 


Remarks 
Emulator 
none 
remarks 


var retVal=ImageViewer.SetDisplayArea(0, 0, 1920, 
Example А 


Support from IMAGEVIEWER-0001 
Security Type 


4.10.1.7. SetDisplayLock 


Function 


SetDisplayLock 
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Lock or unlock the screen 


SetDisplayLock( Boolean lock ) 


e lock 
o Boolean 
Parameter 
o set true to lock the screen or set faluse to unclok the screen 


Return Value . Е : ES 
The return value is true if media player succeed to start play, otherwise it returns false. 


Remarks 


Emulator 
Not supported by enulator 
remarks 


к var retVal=ImageViewer.SetDisplayLock(true); 
Example 


Support from IMAGEVIEWER-0001 
Security Type 


4.10.1.8. SetTransitionEffect 


Function 


SetTransitionEffect 


Set transition effect for slide show 
SetTransitionEffect( Number effect ) 


e effect 

o Number 

o Specifies the effect type 
The effect types are as follow. 
NONE: 2, 

Parameter INIT : -1, 

FADEI : 0, 
FADE2: 1, 
BLIND : 2, 
SPIRAL : 3, 
CHECKRER : 4, 
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LINEAR : 5, 
STAIRS : 6, 
WIPE : 7, 
RANDOM : 8 


Return Value . : | bets 
The return value is true if media player succeed to start play, otherwise it returns false. 


Remarks 


Emulator 
Not supported by enulator 
remarks 


EH var retVal=Image Viewer.SetTransitionEffect(effect); 
Example 


Support from IMAGEVIEWER-0001 
Security Type none 


4.10.1.9. ShowImage 


Function 
ShowImage 


Draw a picture on the screen 


Return Value " E 
It returns true if it succeeds, otherwise it returns false. 


Remarks ShowImage() has to be called with InitPlayer(), and it can't be called with Play(). 
Also ShowImage() can't be called before InitPlayer() is called. 


Emulator 


remarks 


InitPlayer(url); 
SetDisplayArea(x, y, width, height); 
Example ‚2. . 
SetInitialBufferSize(400* 1024); 
//400KB 
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ShowImage(); 


Enumeration none 
Version Support from IMAGEVIEWER-0001 


Security Type Multimedia 


4.10.1.10. Stop 


Function 


Stop 


Stops the currently playing content. 


Return Value қ | . Bona 
The return value is ture if media player succeed to stop, otherwise it returns false. 


ETE var retVal=ImageViewer.Stop(); 
Example 


Support from IMAGEVIEWER-0001 
Security Type 


4.10.3. Event 
4.10.3.1. OnBufferingComplete 


Event 


OnBufferingComplete 


OnBufferingStart event is sent by media player when it gets out of buffering status. 
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remarks | 000000000000 


Image Viewer.OnBufferingComplete=OnBufferingComplete; 


function OnBufferingComplete() 
Example ( 


//unload buffering image. 


IMAGEVIEWER-0001 


4.10.3.2. OnBufferingStart 


Event 


OnBufferingStart 


OnBufferingStart event is sent by media player when it goes on buffering status. 


Emulator 
none 
remarks 
Image Viewer.OnBufferingStart-OnBufferingStart, 


function OnBufferingStart() 
| 


Example 
//Drawing buffering image. 


|IMAGEVIEWER-0001 | 0001 


4.10.3.3. OnConnectionFailed 


Event 


OnConnectionFailed 


OnConnectionFailed event is sent by media player when it fails to connect to streaming server. 
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OnConnectionFailed event is different from OnNetworkDisconnected. 
Remarks 


This event is sent only when media player fails to connect to server at the begining or at the jump in 


HTTP and HTTPS streaming. 
Emulator 


remarks 


Image Viewer.OnConnectionFailed=OnConnectionFailed; 
function OnConnectionFailed() 


{ 


Example 


Image Viewer.Stop(); 


IMAGEVIEWER-0001 


4.10.3.4. OnNetworkDisconnected 


Event 
OnNetworkDisconnected 
OnNetworkDisconnected is sent by media player when it knows that ethernet is disconnected or streaming server stops 


to support content in the middle of streaming. 


Parameter 


Receiving OnNetworkDisconnected event means media player already succeed to connect to 
Remarks | 

streaming server. 

Usually this event means network is disconnected during the streaming. 
Emulator 


remarks 


Example Image Viewer.OnNetworkDisconnected=OnNetworkDisconnected; 


function OnNetworkDisconnected() 
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Image Viewer.Stop(): 


IMAGEVIEWER-0001 


4.10.3.5. OnRenderError 


Event 
OnRenderError 
OnRenderError event is sent by media player when it found that there are some problem in rendering because of the 


reason specified by parameter. 


е renderErrorType 
o Number 
Parameter 
о 


Parameter value of OnRenderError means as follow; 
1 : Unsupported container 
Remarks 
2: Unsupported video codec 
3: Unsupported audio codec 


4: Unsupported video resolution 


Emulator 
none 
remarks 
"a 
IMAGEVIEWER-0001 


4.10.3.6. OnRenderingComplete 


Event 


OnRenderingComplete 


OnRenderingComplete event is sent by media player when it reaches to the end of stream. 


Parameter 
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Remarks 


Emulator 


remarks 


Image Viewer.OnRenderingComplete-OnRenderingComplete, 


function OnRenderingComplete() 
Example { 


Image Viewer.Stop(): 


IMAGEVIEWER-0001 


4.10.3.7. OnStreamInfoReady 


Event 
OnStreamInfoReady 
OnStreamInfoReady event is sent by media player when it is ready to send content information such as duration and 


video resolution after parsing the stream. 


Parameter 


There are a few APIs which gives valid information only when they are called after 
Remarks OnStreamInfoReady() event is sent. 
APIs such as GetDuration(), GetVideoWidth(), and GetVideoHeight() are have to be used after 
widget get OnStreamInfoReady event. 
Emulator 


remarks 


ImageViewer.OnStreamInfoReady=OnStreamInfoReady; 


function OnStreamInfoReady() 
{ 
Example var totaltime=Image Viewer.GetDuration(); 
var width=ImageViewer.GetVideoWidth(); 
var height=Image Viewer.Get VideoHeight(); 
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IMAGEVIEWER-0001 


4.10.3.8. OnStreamNotFound 


Event 


OnStreamNotFound 


OnStreamNotFound event is sent by meida player when it fails to play because streaming server replys that the stream 


specified by url parameter of Play() API is not exist. 


Parameter 
Remarks Цоор»о»»оорооо»»»-»ү0о- 


Emulator 


remarks 


Image Viewer.OnStreamNotFound-OnStreamNotFound, 
function OnStreamNotFound() 


{ 


Ехатріе : 
ImageViewer.Stop(); 


IMAGEVIEWER-0001 


4.11.NNavi 
4.11.1. Function 

4.11.1.1. ActivateReady 
Function 


ActivateReady 


Notify to widget manager that normal widget's initialization is ready. Then widget manager can activate normal widget. 


If success, returns PLR, TRUE. 
Return Value 
Otherwise, returns error code. 
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4.11.1.2. ActivateWithData 


Function 
ActivateWithData 


Activate WithData is thd fuction to implement the specified application. 


ActivateWithData( Number nType, STRRING pszData ) 


nType 

o Number 

o Тһе Application type 
pszData 

o STRRING 


o The String of Filepath, the waiting time for implementation 


Emulator 
none 
remarks 
NNaviPlugin. Activate W ithData( 1, '/TV/data"): 


none 


Support from NNAVI-0003 EI 


4.11.1.3. ChangeWidgetManager 


Function 


ChangeWidgetManager 
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ChangeWidgetManager is called when The ContentsHome needs to update. 


Emulator 


remarks 


var type: 
Example NNaviPlugin.ChangeWidgetManager(); 


Only returns true. 
Support from NNAVI-0002 
Security Type System 


4.11.1.4. GetAppKey 


Function 
GetAppKey 
Returns AppKey of DTV. DTV uses this key when communicating with Samsung Hubsite, and Samsung Hubsite can 


recognize this device is a Samsung DTV by this key. 


If success, return AppKey in DTV 
Return Value 
Otherwise, returns error code. 


AppKey is already fixed before DTV is released, and the AppKey should be already registered in 
Remarks 
Samsung Hubsite. (Unique value in same product line) 


Emulator remarks | Only returns false. 


var appKey; 
appKey = NNaviPlugin.GetAppKey(); 
Example 
alert(appKey); 


Support from NNAVI-0001 
Security Type 
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4.11.1.5. GetDUID 


Function 
GetDUID 


Return DUID (Device Unique ID ) of each DTV. 


GetDUID( STRING МАС) 


STRING 
Parameter MAC : mac address of each DTV. 
Widget can get MAC Address by Network module 


If success, returns DUID of each DTV. ( ех: 7ZXCBNROQJQPYW ) 
Return Value 
otherwise, returns error code. 


13 length, and unique value on each individual DTV. 


var DUID; 

var МАС; 

MAC = NetworkPlugin.GetHW Addr(); 
DUID = NNaviPlugin.GetDUID(MAC), 
alert(DUID); 


Support from NNAVI-0001 
Security Type 


Example 


4.11.1.6. GetFirmware 


Function 
GetFirmware 


Returns Firmware version which is used by Samsung Smart TV to check native source code version. 


GetFirmware( ) 


Syntax 


Parameter 
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If success, returns Firmware version. ( ex: T-SPHAKRC-1000 ) 
Return Value 
Otherwise, error code. 


Firmware version which is used by Samsung Smart TV to check native source code version. 
Emulator remarks | Only returns false. 


var firmware; 

firmware 2 NNaviPlugin.GetFirmware(); 
Example . 

alert(firmware); 


Support from NNAVI-0001 
Security Type 


4.11.1.7. GetModelCode 


Function 
GetModelCode 


Returns model code which is modified for Samsung Smart TV 


If success, returns modified model code. 
Return Value . 
Otherwise, returns error code. 


This function is replaced GetModelCode function of NNavi plugin 

Modified model code is the same as real model code, except that panel size number is replaced 
Remarks 

with XX (refer to GetRealModel()) 

ex) LNXXB650 KOR 


Emulator remarks | [Fake] Returns LNXXB650 КОК 


кеш DevicePlugin.GetModel(); 
Example 


Support from NNAVI-0002 
Security Type 


4.11.1.8. GetPath 
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Function 


GetPath 


Returns path which is root of Widget manager or normal widget. 


GetPath( PL NNAVI PATH widgetType ) 


е  widgetType 
о РІ, NNAVI PATH 
Parameter 
o Widget type to get root path ( WidgetManager or Widget ) 


If success, returns root path required ( ex : /dtv root/widgets/manager ). 
Return Value . 
Otherwise, returns error code. 


Remarks 


Emulator 
Only returns false. 
remarks 


var widgetPath; 
Ei i widgetPath = NNaviPlugin.GetPath(PL NNAVI PATH WIDGET MANAGER): 
xampie 
p alert(widgetPath); 


Enumeration 


Support from ММАУІ-0001 
Security Type | System 


4.11.1.9. GetRemoconType 


Function 
GetRemoconType 


GetRemoconType is the function to get The Remocon Type from the Target location. 


If success, Get The Remocon Type. 
Return Value . 
Otherwise, returns error code. 
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type = NNaviPlugin.GetRemoconType(); 
alert(type); 


Support from NNAVI-0002 
Security Type 


4.11.1.10.  GetServerType 


Function 
GetServerType 


Retuns whether now Samsung Hubsite is for Development or Official release. 


If success, returns one of PL ST SERVICE, РІ, ST DEVELOPMENT, PL ST DEVELOPING 
Return Value 
Otherwise, return error code. 
PL ST SERVICE : Official release server 
Remarks PL ST DEVELOPMENT : Development server for testing 
PL ST DEVELOPING : Developing server including testing and only for developer. 


Emulator remarks | Only returns fasle. 


var serverType; 

serverType = NNaviPlugin.GetServerType(): 
Example 

alert(serverType); 


Enumeration 


Support from NNAVI-0001 
Security Type 


4.11.1.11.  GetSupportPIG 


Function 


GetSupportPIG 
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GetSupportPIG is the function for the decisiont to Support PIG 


If success, returns 1(INFOLINK MODEL CODE) or return 0(BD) 
Return Value 
Otherwise, returns error code. 
Emulator remarks | Only returns false. 


var Type: 

type - NNaviPlugin.GetSupportPIG(): 
Example 

alert(type): 


Support from NN AVI-0001 
Security Type 


4.11.1.12.  GetSystemVersion 


Function 
GetSystem Version 


Returns system version of DTV 


GetSystemVersion( PL NNAVI SYSTEM VERSION versionType ) 
e  versionType 
o PL NNAVI SYSTEM, VERSION 
o PL NNAVI SYSTEM VERSION LEEUM : version of leeum platform 
PL NNAVI SYSTEM VERSION COMP : version of advanced platform 


Emulator 
Only returns false 
remarks 


NNaviPlugin.GetS ystemVersion(PL. NNAVI SYSTEM, VERSION LEEUM); 
Example NNaviPlugin.GetSystem Version(PL NNAVI SYSTEM VERSION COMP), 
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PL NNAVI SYSTEM, VERSION 
Enumeration 


Support from NNAVI-0001 
Security Type 


4.11.1.13. | GetToken 


Function 
GetToken 


Returns token information to communicate with Samsung Hubsite. 


GetToken( STRING SessinID , STRING UserID , STRING SeedKey ) 


e SessinID 

о STRING 

o Need to get using HubSite openAPI 
е UserID 

Parameter ok PAP 

o Need to get using HubSite open API. 
е SeedKey 

о STRING 


o Need to get using HubSite openAPI. 


If success, returns Token. (ех: 111+222+b18a6aeb5e845ecefee59d97 1d82d82b089b0434 ) 
Return Value 
Otherwise, returns error code. 


Remarks 


Emulator 


Only returns false 


remarks 


var token; 

token 2 NNaviPlugin.GetToken(SessionID, UserID, SeedKey); 
Example 

alert(token); 


Support from NNAVI-0001 
Security Type 
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4.11.1.14.  ResetWidgetData 


Function 


ResetWidgetData 


Reset асе а is the function to delete a specified APP Data 


If success, Delete a Selected APP Data 
Return Value 
Otherwise, returns error code. 


Remarks 


Emulator 
Only returns false. 
remarks 


ETE NNaviPlugin.ResetWidgetData(11); 
Example 


Support from NNAVI-0002 
Security Type 


4.11.1.15. _SendEventToDevice 


Function 
SendEventToDevice 


SendEventToDevice is thd fuction to send the event to native. 


SendEventToDevice( INTEGER nEventType , STRRING pszEventData ) 


е nEventType 
о INTEGER 
o Тһе Event type 


Parameter е  pszEventData 
о  STRRING 
o The ATA of events 


Return Value Everytime The return Value is True. 
Request update to Native. 
Only returns false 
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И 


var type; 
Example NNaviPlugin.SendEventToDevice(1," data"); 


Support from NNAVI-0002 
Security Type System 


4.11.1.16. _SetBannerState 


Function 
SetBannerState 


SetBannerState is the function which controls the overlapped OSD. 


SetBannerState( INTEGER nSTATE ) 


е nSTATE 
o INTEGER 
o What kind of Widgets Manager 


Return Value Everytime The return Value is True. 


Parameter 


Request update to Native. 


Emulator 


Only returns false 
remarks 


var type; 
Example NNaviPlugin.SetBannerState( 1), 


Support from NNAVI-0002 
Security Type 


4.11.2. Enumeration 


4.11.2.1. РІ, NNAVI PATH 
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Enumeration 
PL NNAVI PATH 


path of widget 


| Remarks [roe | 


Emulator 


remarks 


Function 


e 0 - PL NNAVI PATH WIDGET MANAGER 
o То get root path of WidgetManager 

e 1 - PL NNAVI PATH WIDGET NORMAL 
o То get root path of Normal Widget 


4.11.2.2. РІ, NNAVI SYSTEM VERSION 


Enumeration 
РІ, NNAVI SYSTEM VERSION 


System version 


Remarks 


Emulator 


remarks 


e  GetSystem Version 
Function 


e 0 - PL NNAVI SYSTEM VERSION LEEUM 
o  LEEUM Platform?version 

e 1- PL NNAVI SYSTEM VERSION COMP 
o COMP version 


4.11.2.3. PL ST 


Enumeration 


PETS: 
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Server type 


Emulator 
none 
remarks 
е”  GetServerType 


e 0 - PL ST SERVICE 
o Official Release server 
e 1- PL ST DEVELOPMENT 
Value o Development server for testing 
e 2- PL ST DEVELOPING 
o Developing server including testing and only for developer 


4.12.Network 
4.12.1. Function 


4.12.1.1. CheckDNS 


Function 
CheckDNS 


pings the DNS 


CheckDNS( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 
0 = wireless 


1 if DNS is reachable 
Return Value 


0 if DNS is not reachable 


-1 if error 


Remarks с) (ооо ыәвозә<хооә-- 
Only returns false. 
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var checkDNS = networkPlugin.CheckDNS(cType); 

if (checkDNS == 1) document.getElementById('CheckDNS').value = "ОК"; 
Example if (checkDNS == 0) document.getElementB yId('CheckDNS ).value = "Failure"; 

if (checkDNS == -1){ document.getElementB yId(‘CheckDNS').value = "Error"; 


return; | 


Support from NETWORK-0001 
Security Type 


4.12.1.2. CheckGateway 


Function 
CheckGateway 


pings the Gateway 


CheckGateway( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
] 2 wired, 
0 = wireless 


1 if Gateway is reachable 
Return Value 

0 if Gateway is not reachable 

-] if error 


| Remarks || 


Emulator 
Only returns false. 
remarks 


Example var checkGW = networkPlugin.CheckGateway(cType); 
if (checkGW == 1) document.getElementById('CheckGateway').value = "ОК"; 
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if (checkGW == 0) document. getElementById('CheckGateway').value = 
"Failure"; 

if (checkGW == -1) {document.getElementB yId('CheckGateway').value = 
"Error"; return; } 


Support from NETWORK-0001 


4.12.1.3. CheckHTTP 


Function 
Check HTTP 


checks Http connectivity 


CheckHTTP( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 
0 = wireless 


1 if HTTP is operating successfully 
Return Value 

0 if HTTP is not available 

-1 if error 


| Remarks | o | 


Emulator 
Only returns false. 
remarks 


var checkHttp = networkPlugin.CheckHTTP(cType): 

борі if (checkHttp== 1) document.getElementB yId(‘HttpTest’).value = "ОК"; 
if (checkHttp== 0) document.getElementById( HttpTest ).value = "Failure"; 
if (checkHttp== -1) (document.getElementB yId('HttpTest ).value = "Error"; 
return; | 
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4.12.1.4. CheckPhysicalConnection 


Function 
CheckPhysicalConnection 


checks the connectivity of cable(for wired) or to accessPoint(wireless) 


CheckPhysicalConnection( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 
0 = wireless 
1 if connected 
Return Value 
0 if not connected 
-1 if error 


ьо 


Emulator 


Only returns false 
remarks 


var phyConnection = networkPlugin.CheckPhysicalConnection(cType); 
if (phyConnection == 1) document.getElementB yId('PhysicalConnection").value 
= "ОК"; 

Example if (phyConnection == 0) document.getElementB yId( PhysicalConnection').value 
= "Failure"; 
if (phyConnection == -1) 


(document.getElementB yId(‘PhysicalConnection').value = "Error"; return; } 
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Support from NETWORK-0001 


Security Type 


4.12.1.5. CreatePlugin 


Function 
CreatePlugin 
Create Plugin instance. Must be called prior to all other functions. 


OBSOLETE function 


True if success. In case of error, or if plugin instance already exists returns False. 


Emulator 
[FAKE] Do nothing, just print out function name on debug console in SDK. 
remarks 
function OnLoadFunc() 
{ 
networkPlugin = 
document.embeds[0]: 


Example | ; 
networkPlugin.CreatePlugin(); 


Support from NETWORK-0001 
Security Type 


4.12.1.6. GetActiveType 


Function 


GetActiveType 


get the current active interface(Wired or Wireless) 
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lif acitve interface is WIRED 
Return Value 

0 if active interface is WIRELESS 

-1 if no active connection 


| Remarks О 


Emulator 


Only returns true. 
remarks 


var сТуре = networkPlugin.GetActiveType(); 


if (сТуре == 1) document.getElementById(' ActiveConnection').value = "wired"; 


if (сТуре == 0) document.getElementByld('ActiveConnection').value = 
"wireless"; 

if (сТуре == -1) 

| 


Example 


document.getElementBylId('ActiveConnection').value = "no active 
connection": 


return, 


Support from NETWORK-0001 
Security Type none 


4.12.1.7. GetDNS 


Function 
GetDNS 


get DNS address 


GetDNS( Number interfaceType ) 


e  interfaceType 
o Number 
Parameter 
o This function accepts call with One parameter Or WITHOUT parameter 
type of interface (Wired/Wireless) 
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1 = Wired, 
0 = wireless 
if called WITHOUT parameter it returns result for WIRED network 


Return Value DNS address string if success, 
NULL string if error 


| Remarks qp 
Emulator remarks | Only returns false 


//for wired interface 

var mac = networkPlugin.GetDNS(1); 
Example . 

//or with default parameter 


var mac = networkPlugin.GetDNS(); 


Support from NETWORK-0001 
Security Type 


4.12.1.8. GetDNSMode 


Function 


GetDNSMode 


get DNS type (Auto/Manual) 


GetDNSMode( Number interfaceType ) 


е  interfaceType 


o Number 


o type of interface (Wired/Wireless) 


Parameter 


Return Value 0 if Auto 
1 if Manual 
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0 = wireless 
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н 
Т ООО 


Emulator 


Only returns false 


remarks 


var сТуре = networkPlugin.GetActiveType(); 
Example if (cType !- -1) 
var DnsType - networkPlugin.GetDNSMode(cType): 


Support from NETWORK-0001 
Security Type 


4.12.1.9. GetGateway 


Function 
GetGateway 


get Gateway address 


GetGateway( Number interfaceType ) 


e  interfaceType 
o Number 
o This function accepts call with One parameter Or WITHOUT parameter 
type of interface (Wired/Wireless) 
Parameter 1 = wired, 
0 = wireless 
if called WITHOUT parameter it returns result for WIRED network 


Return Value Gateway address string if success, 
NULL string if error 


кык | |00000, 
Emulator remarks | Only returns false 
eem И 
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//for wired interface 


var mac - networkPlugin.GetGateway(1); 


//or with default parameter 


var mac = networkPlugin.GetGateway(); 


Support from NETWORK-0001 
Security Type none 


4.12.1.10. | GetHostAddr 


Function 
GetHostAddr 


OBSOLETE function. Returns IP address for Wired interface. 


Return Value IP address string for WIRED interface if success, 
NULL string if error 


Supported but OBSOLETE. Use GetIP() instead. 
Emulator remarks | Only returns false 
ame | 77 7 


Enumeration none 


Support from NETWORK-0001 
Security Type 


4.12.1.11. GetHWaddr 


Function 


GetHWaddr 


OBSOLETE function. Returns MAC address for Wired interface. 
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Return Value MAC address string for WIRED interface if success, 
NULL string if error 


Supported but OBSOLETE. Use GetMACY) instead. 
Emulator remarks | Only returns false. 


"Те О 


4.12.1.12. СейР 


Function 
GetIP 


get IP address 


GetIP( Number interfaceType ) 


e  interfaceType 
o Number 
o This function accepts call with One parameter Or WITHOUT parameter 
type of interface (Wired/Wireless) 
Parameter ] 2 wired, 
0- wireless 
if called WITHOUT parameter it returns result for WIRED network 


Return Value IP address string if success, 
NULL string if error 


къы qa | 
Emulator remarks | Only returns false. 


//for wired interface 

Example | 
var тас = networkPlugin.GetIP(1); 
Гог with default parameter 
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ШЕН var mac = networkPlugin.GetIP(); 


Support from NETWORK-0001 
Security Type 


4.12.1.13.  GetIPMode 


Function 


GetIPMode 


get IP address type (Auto/Manual) 


GetIPMode( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 
0 = wireless 


0 if Auto 
1 if Manual 


Return Value 


-1 if error 


| Remas ОО 


Emulator 


Only returns false. 


remarks 


var сТуре = networkPlugin.GetActiveType(); 
Example if (сТуре != -1) 
var ipType - networkPlugin.GetIPMode(cType): 


Support from NETWORK-0001 
Security Type 
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4.12.1.14. GetMAC 


Function 
GetMAC 


get MAC address 


GetMAC( Number interfaceType ) 


e  interfaceType 
o Number 
o This function accepts call with One parameter Or WITHOUT parameter 
type of interface (Wired/Wireless) 
Parameter 1 = wired, 
0 = wireless 
if called WITHOUT parameter it returns result for WIRED network 


Return Value MAC address string if success, 
NULL string if error 


кав 000000000000) 
Emulator remarks | Only returns false. 


//for wired interface 

var mac = networkPlugin.GetM AC ( 1), 
Example . 

Гог with default parameter 


var mac = networkPlugin.GetMAC(); 


Support from NETWORK-0001 
Security Type 


4.12.1.15. GetNetMask 


Function 


GetNetMask 
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get NetMask address 


GetNetMask( Number interfaceType ) 


e  interfaceType 
o Number 
o This function accepts call with One parameter Or WITHOUT parameter 
type of interface (Wired/Wireless) 
Parameter 1 = wired, 
0 = wireless 
if called WITHOUT parameter it returns result for WIRED network 


Return Value NetMask address string if success, 
NULL string if error 


къы | | 
Emulator remarks | Only returns false 


//for wired interface 

var mac = networkPlugin.GetNetMask(1); 
Example . 

//or with default parameter 


var mac = networkPlugin.GetNetMask(); 


Support from NETWORK-0001 
Security Туре 


4.12.1.16. _GetNetworkInfo 


Function 
GetNetworkInfo 


OBSOLETE function 
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ct always returns PLR TRUE 
Supported but OBSOLETE. 
Emulator remarks | Only returns false 


sawa О 
Support from NETWORK-0001 


4.12.1.17.  GetNetworkType 


Function 


GetNetworkType 


OBSOLETE function 


Return Value 
PLR NOT IMPLEMENT 


please do not use this function. Use Get ActiveType() instead. 
awe | 


4.12.1.18.  GetStatus 


Function 
GetStatus 


OBSOLETE function. Get interface status: active or not active 


GetStatus( Number interfaceType ) 


е  interfaceType 
Parameter o Number 
о 
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type of interface (Wired/Wireless) 
1 = Wired, 
0 = wireless 
Return Value 1 - interface is active 
-1 interface is not acitve or error 


4.12.1.19.  IsValidDNS 


Function 
IsValidDNS 


validates DNS address 


IsValidDNS( Number interfaceType ) 


е  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 


0 = wireless 


1 if DNS address is valid 
Return Value 
0 if DNS is not valid 


-1 if error 


| Remarks | 000000000000. 


Emulator 


Only returns true 


remarks 


ange | 
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if (networkPlugin.Is ValidMAC(cType) == 1 && 
networkPlugin.IsValidIP(cType) -- 1 && 
networkPlugin.IsValidSubnetMask(cType) == 1 && 
networkPlugin. а == | && 
networkPlugin.IsValidDNS(cType) == 
document.getElementB yId( Validate"). ом = Око 
document.getElementByld('Validate').value = "Failure"; 
return; 


Support from NETWORK-0001 
Security Type 


4.12.1.20. IsValidGateway 


Function 
IsValidGateway 


validates Gateway address 


IsValidGateway( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 
0 = wireless 


1 if Gateway address is valid 
Return Value 

0 if Gateway is not valid 

-] if error 


| Кеше | 000000000000. 


Emulator 
Only returns true 
remarks 
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if (networkPlugin.Is ValidMAC(cType) == 1 && 
networkPlugin.IsValidIP(cT ype) == 1 && 
networkPlugin.IsValidSubnetMask(cType) == 1 && 
networkPlugin.IsValidGateway(cType) == 1 && 
networkPlugin.IsValidDNS(cType) == 1) 
Example document.getElementByld('Validate').value = "OK"; 


document.getElementByld('Validate').value = "Failure"; 


return; 


Support from NETWORK-0001 
Security Type 


4.12.1.21.  IsValidIP 


Function 
IsValidIP 


validates IP address 


IsValidIP( Number interfaceType ) 


e  interfaceType 
o Number 
o type of interface (Wired/Wireless 
Parameter р ( ) 
1 = Wired, 
0 = wireless 


1 if IP address is valid 
O if IP is not valid 


Return Value 


-1 if error 


ТИ U 
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if (networkPlugin.Is ValidMAC(cType) == 1 && 
networkPlugin.IsValidIP(cType) -- 1 && 
networkPlugin.IsValidSubnetMask(cType) == 1 && 
networkPlugin. .. == | && 
networkPlugin.IsValidDNS(cType) == 
Example document.getElementB yId( Validate"). е = "ОК"; 


document.getElementByld('Validate').value = "Failure"; 


return, 


Support from NETWORK-0001 
Security Type 


4.12.1.22.  IsValidMAC 


Function 
IsValidMAC 


validates MAC address 


IsValidMAC( Number interfaceType ) 


e  interfaceType 
o Number 


o type of interface (Wired/Wireless) 
Parameter 


1 = wired, 


0 = wireless 


1 if MAC address is valid 
0 if MAC is not valid 


Return Value 


-1 if error 


| Remas | 000000000000 


@Samsung Electronics Copyright АП Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


Emulator 
Only returns true 
remarks 


if (networkPlugin.Is ValidMAC(cType) == 1 && 
networkPlugin.IsValidIP(cType) == 1 && 
networkPlugin.IsValidSubnetMask(cType) == 1 && 
networkPlugin.IsValidGateway(cType) == 1 && 
networkPlugin.IsValidDNS(cType) == 1) 
Example document.getElementByld('Validate').value = "OK"; 


document.getElementByld('Validate').value = "Failure"; 


return; 


Support from NETWORK-0001 
Security Type 


4.12.1.23. - IsValidSubnetMask 


Function 
Is ValidSubnetMask 


validates SubNet Mask address 


IsValidSubnetMask( Number interfaceType ) 


е  interfaceType 
o Number 
o type of interface (Wired/Wireless) 
Parameter 
1 = wired, 
0 = wireless 
1 if SubNet Mask address is valid 
Return Value 
0 if SubNet Mask is not valid 
-1 if error 
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къыз | 000000000000. 


Emulator 
Only returns true 
remarks 


if (networkPlugin.Is ValidMAC(cType) == 1 && 
networkPlugin.IsValidIP(cType) == 1 && 
networkPlugin.IsValidSubnetMask(cType) == 1 && 
networkPlugin.IsValidGateway(cType) == 1 && 
networkPlugin.IsV alidDNS(cType) == 1) 


Example document.getElementByld('Validate').value = "OK"; 


document.getElementByld('Validate').value = "Failure"; 


return; 


Support from NETWORK-0001 
Security Type 


4.12.1.24.  SetDNSMode 


Function 


SetDNSMode 


set DNS type (Auto/Manual) 
SetDNSMode( Number interfaceType , Number mode ) 


e  interfaceType 

o Number 
type of interface (Wired/Wireless) 
1 = wired, 

Parameter 

0- wireless 
Number 
set IP mode (Auto/Manual) 
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Return Value 1 if succeess 
-1 if error 


| Remarks fd 


Emulator 


Only returns false 


remarks 


var сТуре = networkPlugin.GetActiveType(); 
if (cType != -1) 
Example ; 
var result = networkPlugin.SetDNSMode(cType,0); 


Support from NETWORK-0001 
Security Type 


4.12.1.25. | SetIPMode 


Function 
SetIPMode 


set IP address type (Auto/Manual) 


SetIPMode( Number interfaceType , Number mode ) 


е  interfaceType 
o Number 
type of interface (Wired/Wireless) 
1 = wired, 
0 = wireless 


Parameter 


Number 


set IP mode (Auto/Manual) 
0 = Auto, 
1- Manual 
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1 if succeess 
-] if error 
| Remarks S 


var сТуре = networkPlugin.GetActiveT ype(); 
if (сТуре != -1) 
Example : 
var result = networkPlugin.SetIPMode(cType, 0); 


Support from NETWORK-0001 
Security Type 


4.13.Player 
4.13.1. Function 


4.13.1.1. ClearScreen 


Function 
ClearScreen 


This ClearScreen() erases TV screen with black. 


Return Value = 2. 
It returns ture if it succeeds, otherwise it returns false. 


4.13.1.2. GetAvailableBitrates 
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Function 


Get AvailableBitrates 


GetAvailableBitrates() function retrieves available bitrestes of currently playing content for adaptive streaming. 


GetAvailableBitrates( ) 


The GetAvailableBitrates() returns available bitrates information for currently playing content in 
String format. 

Return Value Each bitrates in byte are separated by separator '|. 
For example, if currently playing content can support 3 different bitrates for adaptive streaming, 
100Kbps, 200kbps, 300kbps, 
then Get AvailableBitrates() returns string '102400|204800|307200'. 


Remarks 
This GetAvailableBitrates() returns valid value only when it is called after calling Play). 
Emulator 
none 
remarks 
var bitratesInfo-Player.GetA vailableBitrates(); 
Example 


Support from PLAYER-0001 
Security Type 


4.13.1.3. GetCurrentBitrates 


Function 


GetCurrentBitrates 


GetCurrentBitrates() retrieves the bitrates of currently playing content. 
GetCurrentBitrates( ) 


Return Value 
The GetCurrentBitrates() returns bitrates of currently playing content in byte number format. 


Remarks 


This GetCurrentBitrates() returns valid value only when it is called after calling Play). 
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ETE var bps-Player.GetCurrentBitrates(); 
Example 


Enumeration | 


Support from PLAYER-0001 
Security Type 


4.13.1.4. GetDuration 


Function 
GetDuration 


GetDuration() retrieves the duration of currently playing content. 


Syntax GetDuration( ) 
Parameter 


Return Value : "PNE : 
GetDuration() returns the total playing time if it succeed, otherwise return -1. 


Remarks 
This GetDuration() API has be called after OnStreamInfoReady callback function is called. 


Emulator remarks 


var totalTime=Player.GetDuration(); 
Example 


Version Support from PLAYER-0001 


4.13.1.5. GetPLiveDuration 


Function 


GetLiveDuration 


GetLiveDuration() retrieves duration of current live contents media server can support. 
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GetLiveDuration() returns string which include start and end time of current live content that 
media server can support for current time. 

Remarks + . . . D . . . . 
This API is available only for some contents which use Widevine live streaming solution. 


var retVal=GetLiveDuration(); 
Example 


Support from PLAYER-0004 
Security Type 


4.13.1.6. GetPlayerVersion 


Function 
GetPlayer Version 


GetPlayer Version retrieves the version of media player. 


GetPlayer Version( ) 


Return Value 
GetPlayer Version() returns the version of media player in the form of 'UNIPLYAER-000000'. 


Remarks none 


var version=GetPlayerVersion() 
Example 


Support from PLAYER-0001 
Security Type 


4.13.1.7. GetVideoHeight 


Function 


Get VideoHeight 


GetVideoHeight() function retrieves height of currently playing video. 
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Return Value 
GetVideoHeight returns the height size of currently playing video content. 
Remarks 
This GetVideoHeight() API has be called after OnStreamInfoReady callback function is called. 


ETE var width=Player.GetVideoHeight(); 
Example 


Support from PLAYER-0001 
Security Type Multimedia 


4.13.1.8. GetVideoWidth 


Function 


Get VideoWidth 


GetVideoWidth() function retrieves width of currently playing video. 


Return Value 
Get Video Width returns the width size of currently playing video content. 


Remarks 
ETE This GetVideoWidth() API has be called after OnStreamInfoReady callback function is called. 


ETE var width-Player.GetVideoWidth): 
Example 


Support from PLAYER-0001 


4.13.1.9. InitPlayer 


@Samsung Electronics Copyright АП Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


Function 


InitPlayer 


Initialize media player with the specified url. 


InitPlayer( String url ) 


String 
Parameter 
Specifies the URL of content to play 


Return Value 
It always returns ture. 


The InitPlayer() should not be used with Play() API. 

Remarks If widget uses InitPlayer(), it has to use StartPlayback() to play a content. 
Otherwidget it has to use Play() only. 
When InitPlayer() is used, it has to come first becore other APIs are called. 


Emulator 

remarks 
Player.InitPlayer(url); 
SetDisplayArea(x, y, width, height); 
SetInitialBufferSize(400* 1024); 

Example 


//400KB 
StartPlayback(): 


Support from PLAYER-0001 
Security Type 


4.13.1.10.  JumpBackward 


Function 


JumpBackward 


JumpBackward( Number offset ) 
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e offset 
o Number 
Parameter 
o M Relative time offset from current time in second 


Return Value : . : : Loi 
The return value is ture if media player succeed to jump, otherwise it returns false. 


Emulator remarks | Implemented like TV's API 


ETE var retVal=Player.JumpBackward(30); 
Example 


Support from PLAYER-0001 


4.13.1.11.  JumpForward 


Function 


JumpForward 


JumpForward( Number offset ) 


e offset 
o Number 
Parameter 
o M Relative time offset from current time in second 


Return Value | . . ; Бе 
The return value is ture if media player succeed to jump, otherwise it returns false. 


ETE var retVal-Player.JumpForward(30); 
Example 


Support from PLAYER-0001 
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4.13.1.12. Pause 


Function 


Pause 


Pauses the currently playing content. 


Return Value : : : Бе 
The return value is ture if media player succeed to pause, otherwise it returns false. 


E var retVal=Player.Pause(); 
Example 


| Enumeration О 
Support from PLAYER-0001 
Security Type 


4.13.1.13. Play 


Function 
Play 


Starts playing a content specified by url. 


String 
Parameter 
Specifies the URL of content 


Return Value . : | ME 
The return value is true if media player succeed to start play, otherwise it returns false. 


var retVal=Player.Play(url); 


Example 
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Support from PLAYER-0001 


Security Type 


4.13.1.14. | Resume 


Function 
Resume 


Resume currently paused content. 


Return Value . . : c 
The return value is ture if media player succeed to resume, otherwise it returns false. 


ETE var retVal=Player.Resume(); 
Example 


CT | 
Support from PLAYER-0001 
Security Type 


4.13.1.15. | ResumePlay 


Function 
ResumePlay 


Starts playing a content specified by url. 


ResumePlay( String url, Number sec) 


String 

Specifies the URL of content 
Parameter 

Number 

Specifies the position of content in sec 
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Return Value 
The return value is true if media player succeed to start play, otherwise it returns false. 
Remarks 
The ResumePlay() is used when a widget want to play from bookmark point. 


ETE var retVal=Player.ResumePlay(url, 3600); 
Example 


[meme | E 
Support from PLAYER-0001 


Security Type 


4.13.1.16.  SetCropArea 


Function 


SetCrop Area 


SetCropArea() sets the cropped aread of orginal image which widget wants to display. 
SetCropArea( Number x, Number у, Number width, Number height ) 


Number 
Specify the initial horizontal position of the cropped image. 
The initial x-coordinate of the upper-left corner of the cropped image relative 
to the upper-left corner of the orginal image. 
Number 
Parameter 
Specifies the initial vertical position of the cropped image. 
The initial y-coordinate of the upper-left corner of the cropped image relative 
to the upper-left corner of the orginal image. 
Number 
Specifies the width of cropped area. 
This value must be smaller than width of original image. 
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e height 
o Number 
о 
Specifies the height of crop area. 
This value must be smaller than height of original image. 


Return Value 2 2. 
It returns ture if it succeeds, otherwise it returns false. 


ETE var retVal-Player.SetCropArea(0, 100, 1920, 880); 
Example 


| Emmertin ОО 
Support from PLAYER-0001 
Security Туре 


4.13.1.17.  SetDisplayArea 


Function 
SetDisplayArea 


SetDisplay Area() sets the display area for video content in TV screen. 


SetDisplayArea( Number x, Number y,Number width, Number height ) 


Number 

Specifies the initial x-coordinate of display area in TV screen coordinates. 
This x value must be smaller than TV screen width, 960. 

Parameter 

Number 

Specifies the initial y-coordinate of display area in TV screen coordinates. 
This y value must be smaller than TV screen height, 540. 

Number 
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The width of display area. 


This value must be smaller than width of TV screen. 
Number 


The height of crop area from source Image. 


This value must be smaller than height of source image. 


Return Value Bu ғ 
It returns ture if it succeeds, otherwise it returns false. 


ETE var retVal=Player.SetDisplayArea(0, 0, 1920, 1080); 
Example 


| Emumeration | 
Support from PLAYER-0001 
Security Type 


4.13.1.18.  SetICT 


Function 


SetICT 


SetICT() specifies ICT output level. 


SetICT( bool bICTOn ) 


. bICTOn 
o bool 
о 
Рагате(ег Specifies the ICT output level. 
true : ICT On 
false : ICT off 


Return Value 


бейСТО returns true if it succeeds, otherwise it returns false. 
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Remarks This API has to be called when OnStreamInfoReady callback is called. 
If widget doesn't call this function, system will off the ICT. 


E var retVal-SetICT(false); 
Example 


Support from PLAYER-0001 
Security Type 


4.13.1.19. SetInitialBuffer 


Function 


SetInitialBuffer 


SetInitialBuffer sets the first buffering size in percent of buffer size before starting playback. 


SetInitialBuffer( Number byte) 


. byte 
o Number 
Parameter o Specifies the initial buffering size in byte 
This API is optional and media player has default value. 


4.13.1.20.  SetInitiaITimeOut 
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Function 


SetInitial TimeOut 


SetInitialTimeOut sets the maximum time out value for initial buffering before starting playback. 


SetInitialTimeOut( Number second ) 


е second 
o Number 
о 
Parameter 
Specifies the time out value for initial buffering before starting playback. 
This API is optional and media player has default value. 


Return Value Е Bu mE 
SetInitialBuffer() returns true if it succeeds, otherwise it returns false. 


ETE var retVal-SetInitialTimeOut(30); 
Example 


Support from PLAYER-0001 
Security Type 


4.13.1.21.  SetMacrovision 


Function 


SetMacrovision 


SetMacrovision() specifies macrovision level. 


SetMacrovision( Number macrovisionType ) 


e  macrovisionType 
o Number 


о 


Parameter Specifies the macrovision level. 
0: APS ALL OFF 
1: APS АСС ON ONLY 
2:APS AGC ON CS 2L 
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Ў 3:АРЅ АСС ON CS 4L 
Return Value 
SetMacrovision() returns true if it succeeds, otherwise it returns false. 


This API has to be called when OnStreamInfoReady callback is called. 

Remarks If widget doesn't call this function, system will not set macrovision level, so the level will be O. 
If widget wants to protect contents or want to use differenct level of protection, widget has to call 
this API. 


Emulator 
none 
remarks 
var retVal=SetMacrovision(3); 
Example 


Support from PLAYER-0003 


4.13.1.22. SetPendingBuffer 


Function 


SetPendingBuffer 


SetPendingBuffer() specifies the size of buffer in percent of total buffer size that media player goes out from buffering 


status. 


SetPendingBuffer( Number byte) 


Number 


Specifies the buffer size in byte which media player goes out from 


Parameter 
buffering. 


This API is optional and media player has default value. 


Return Value Е m -— 
SetInitialBuffer() returns true if it succeeds, otherwise it returns false. 
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ETE var retVal-SetPendingBuffer(512«1024); //512KB 
Example 


|_ Enumeration mone по 
Support from PLAYER-0001 


4.13.1.23.  SetPlaybackSpeed 


Function 
SetPlaybackSpeed 


SetPlaybackSpeed() sets playback speed of contents. 


SetPlaybackSpeed( Number speed ) 


e speed 
o Number 
о 
Parameter 
Specifies the playback speed in multiple of 2. 
This can be negative integer for backward playback. 


Return Value The return value is ture if media player succeed to play in the speed specified by paramter, 
otherwise it's false. 
Remarks 
SetPlaybackSpeed() has be called after Play() function is called. 


ETE var retValzSetPlaybackS peed(2); 
Example 


Support from PLAYER-0001 


4.13.1.24. X SetPlayerProperty 


Function 
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SetPlayerProperty 


SetPlayerProperty sets property such as Cookie to media player 


SetPlayerProperty( Number Type , String StrParam , Number NumParam ) 


e Type 
o Number 
o Specifies the type of property widget want to set. 
1 : Cookie 
е StrParam 
o String 
o Specifies the string parameter of property defined in 1st, Type, 
Parameter parameter. 
ex) Cookie value for cookie property. 
е NumParam 
o Number 
o Specifies the number parameter of property defined in 1st, Type, 
parameter. 
ex) Cookie value length for cookie property. 


қ А This API has to be called between DU and StartPlayback(). 
етагк$ 
Thus, Play() must not Бе used to use SetPlayerProperty(). 


Emulator 
remarks 


InitP layer (URL); 
SetTotalBufferSize(size); //Optional 
Example SetPlayerProperty(1, "CookieValue", CookievalueLength); //Set 
cookie 
StartPlayback(sec) 


EH 
Support from PLAYER-0006 


4.13.1.25. “ SetTotalBufferSize 
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Function 
SetTotalBufferSize 


SetTotalBufferSize sets stremaing buffer size of media player. 


SetTotalBufferSize( Number size ) 


Number 


Parameter 
Specifies the total buffer size for streaming in bytes. 


This API is optional and media player has default value. 


Return Value . man KON 
SetTotalBufferSize() returns true if it succeeds, otherwise it returns false. 


Emulator 
none 
remarks 
var retVal-SetTotalBufferSize(5*1024*1024); //5МВ 


Support Нот PLAYER-0001 
Security Type 


4.13.1.26.  SetVBIData 


Function 


SetVBIData 


SetVBIData() specifies VBIData output level. 


SetVBIData( Number macrovisionType , Number cgmsType ) 


e  macrovisionType 
o Number 


о 


Parameter Specifies the macrovisionType level. 
0:APS ALL OFF 
1: APS AGC ON ONLY 
2:APS AGC ON CS 2L 
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3:APS АСС ON CS 4L 
e cgmsType 

o Number 

о 
Specifies the cgmsType level. 
0: CGMS COPY FREE 
1: CGMS COPY NO MORE 
2:CGMS COPY ONCE 
3:CGMS COPY NEVER 


Return Value " е 
SetVBIData() returns true if it succeeds, otherwise it returns false. 


This API has to be called when OnStreamInfoReady callback is called. 

If widget doesn't call this function, system will not set VBIData output level, so the lowest level 
Remarks will be applied. 

If widget wants to protect contents or want to use differenct level of protection, widget has to call 

this API. 

The default is APS ALL OFF with CGMS COPY FREE. 


ЕСІ var retVal-SetV BIData(3, 3); 
Example 


Support from PLAYER-0003 
Security Type 


4.13.1.27. StartPlayback 


Function 


StartPlayback 


Start playback of contents 
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Return Value 
It returns true if it succeeds, otherwise it returns false. 
Remarks StartPlayback() has to be called with InitPlayer(), and it can't be called with Play). 
Also StartPlaybac() can't be called before InitPlayer() is called. 


Emulator 
none. 
remarks 


Player.InitPlayer(url); 


SetDisplayArea(x, y, width, height); 
SetInitialBufferSize(400* 1024); 
Example 


//400KB 
StartPlayback(): 


Support from PLAYER-0001 
Security Type 


4.13.1.28. Stop 


Function 
Stop 


Stops the currently playing content. 


Return Value | | | 
The return value is ture if media player succeed to stop, otherwise it returns false. 


ETE var retVal=Player.Stop(); 
Example 


Support from PLAYER-0001 
Security Type 
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4.13.3. Event 


4.13.3.1. OnAdEnd 


Event 


OnAdEnd 


Event to notify that playback for advertisement is finished. This event is available only for some specific contents which 


use HAS streaming solution. 


Emulator 
none 
remarks 


Player.OnAdEnd-OnAdEnd; 
function OnAdEnd() 


{ 


Example 


4.13.3.2. OnAdStart 


Event 
OnAdStart 
Event to notify that playback for advertisement is started. This event is available only for some specific contents which 


use HAS streaming solution. 


Parameter 
Remarks 


Emulator 
none 
remarks 


Player.OnAdStart-OnAdStart, 
function OnAdStart() 
Example | 
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4.13.3.3. OnConnectionFailed 


Event 
OnAuthenticationFailed 


OnConnectionFailed event is sent by media player when it fails to play because authentication process has been failed. 


ши КЕЗЕ 


Remarks 


Emulator 


remarks 


Player.OnAuthenticationFailed=OnAuthenticationFailed; 


function OnAuthenticationFailed() 


{ 


Example 


Player.Stop(); 


4.13.3.4. OnBufferingStartComplete 


Event 


OnBufferingComplete 


OnBufferingStart event is sent by media player when it gets out of buffering status. 
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Remarks 


Emulator 


remarks 


Player.OnBufferingComplete-OnBuffering Complete: 


function OnBufferingComplete() 
{ 


Example TE 
//unload buffering image. 


4.13.3.5. OnBufferingProgress 


Event 
OnBufferingProgress 
OnBufferingProgress event is sent by media play to notify how much data it has to receive more to get out from 


buffering status. 


e percent 
o Number 
Parameter 
о 


Remarks 
The minimum value of parameter is O and the maximum is 100. 


Emulator 


remarks 


Player.OnBufferingProgress=OnBufferingProgress; 
function OnBufferingProgress() 
Example { 
//Draing buffering progress bar. 
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4.13.3.6. OnBufferingStart 


Event 


OnBufferingStart 


OnBufferingStart event is sent by media player when it goes on buffering status. 


Parameter 
Remarks 


Emulator 
none 
remarks 


Player.OnBufferingStart-OnBufferingStart, 
function OnBufferingStart() 


{ 


Example . on 
//Drawing buffering image. 


4.13.3.7. OnConnectionFailed 


Еуепі 


OnConnectionFailed 


OnConnectionFailed event is sent by media player when it fails to connect to streaming server. 


Parameter 


OnConnectionFailed event is different from OnNetworkDisconnected. 
Remarks 


This event is sent only when media player fails to connect to server at the begining or at the jump in 


HTTP and HTTPS streaming. 


Emulator 


remarks 
Example . . . . 
Player.OnConnectionFailed=OnConnectionFailed; 
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function OnConnectionFailed() 


| 


Player.Stop(): 


4.13.3.8. OnCurrentPlay Time 


Event 


OnCurrentPlayTime 


OnCurrentPlayTime is sent by media player to notify current playback time. 


e milli-sec 
o Number 
Parameter 
о 


Emulator 
none 
remarks 
Player.OnCurrentPlayTime=OnCurrentPlayTime; 


function OnCurrentPlayTime() 


Example { 


4.13.3.9. OnNetworkDisconnected 


Event 


OnNetworkDisconnected 


OnNetworkDisconnected is sent by media player when it knows that ethernet is disconnected or streaming server stops 
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to support content in the middle of streaming. 


Parameter 


Receiving OnNetworkDisconnected event means media player already succeed to connect to 
Remarks р 

streaming server. 

Usually this event means network is disconnected during the streaming. 


Emulator 
none 
remarks 


Player.OnNetworkDisconnected-OnNetworkDisconnected: 


function OnNetworkDisconnected() 


{ 


Example 


Player.Stop(); 


4.13.3.10. OnRenderError 


Event 
OnRenderError 
OnRenderError event is sent by media player when it found that there are some problem in rendering because of the 


reason specified by parameter. 


е renderErrorType 
o Number 
Parameter 
о 


Parameter value of OnRenderError means as follow; 
1: Unsupported container 

Remarks 
2 : Unsupported video codec 


3 : Unsupported audio codec 


4 : Unsupported video resolution 
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remarks 


aa | 


4.13.3.11. _OnRenderingComplete 


Event 


OnRenderingComplete 


OnRenderingComplete event is sent by media player when it reaches to the end of stream. 


Emulator 
none 
remarks 
Player. OnRenderingComplete=OnRenderingComplete; 
function OnRenderingComplete() 


Example { 
Player.Stop(); 


4.13.3.12.  OnResolutionChanged 


Event 
OnResolutionChanged 
Event to notify that the Video resolution has been changed during playback. This event is available only for some 


specific contents which use HAS streaming solution. 


Parameter 


Remarks 


Emulator 


remarks 
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Player.OnResolutionChanged=OnResolutionChanged; 


function OnResolutionChanged() 
{ 


4.13.3.13.  OnStreamInfoReady 


Event 

OnStreamInfoReady 

OnStreamInfoReady event is sent by media player when it is ready to send content information such as duration and 
video resolution after parsing the stream. 


Parameter 


There are a few APIs which gives valid information only when they are called after 
Remarks OnStreamInfoReady() event is sent. 
APIs such as GetDuration(), GetVideoWidth(), and GetVideoHeight() are have to be used after 
widget get OnStreamInfoReady event. 
Emulator 
remarks 
Player.OnStreamInfoReady=OnStreamInfoReady; 
function OnStreamInfoReady() 
{ 
var totaltime=Player.GetDuration(); 
var width-Player.GetV ideoWidth(); 
var height=Player.GetVideoHeight(); 


Example 
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4.13.3.14. OnStreamNotFound 


Event 
OnStreamNotFound 


OnStreamNotFound event is sent by meida player when it fails to play because streaming server replys that the stream 


specified by url parameter of Play() API is not exist. 


Emulator 


remarks 


Player.OnStreamNotFound=OnStreamNotFound; 
function OnStreamNotFound() 
{ 


Example 


Player.Stop(): 


4.14.Screen 
4.14.1. Function 

4.14.1.1. Check3DEffectMode 
Function 


Check3DEffectMode 


Check3DEffectMode function returns whether 3DEffect mode can be chagend to input mode or not 


Check3DEffectMode( PL SCREEN 3DEFFECT MODE mode ) 


PL SCREEN 3DEFFECT MODE 
Parameter 
3DEffect mode 
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If success, returns positive value 
otherwise, returns negative value 
none 


Only returns false. 


Щ 1 == ScreenPlugin.Flag3DEffectSupport() ) 
{ 
if PL SCREEN 3DEFFECT MODE SIDE BY 5ШЕ == 
ScreenPlugin.Get3DEffectMode() ) 
{ 
if( 1 == 
ScreenPlugin.Check3DEffectMode(PL SCREEN 3DEFFECT MODE OFF), 
{ 


ScreenPlugin.Set3DEffectMode(PL SCREEN 3DEFFECT MODE OFF); 


if( 1 == 
ScreenPlugin.Check3 DEffectMode(PL_SCREEN_3DEFFECT_MODE_SIDE_BY_SI 
DE); 


ScreenPlugin.Set3 DEffectMode(PL_SCREEN_3DEFFECT_MODE_SIDE_ 
BY SIDE); 


е PL SCREEN 3DEFFECT MODE 


Support from SCREEN-0002 
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4.14.1.2. Flag3DTVConnect 


Function 


Flag3DTVConnect 


Flag3DTVConnect function returns whether connect TV supports 3DEffect or not. call 
this function only on BD 


Return If connected TV supports 3DEffect, returns positive value 
otherwise, returns negative value 


Emulator 
remarks 


if( 1 == ScreenPlugin.Flag3DTVConnect() ) 
1 
if( PL. SCREEN 3DEFFECT. MODE. SIDE BY SIDE == 
ScreenPlugin.Get3DEf fectMode() ) 
1 
if( 1 = 
ScreenPlugin.Check3DEf fectMode(PL SCREEN 3DEFFECT. MODE. OFF): 
{ 
Scr eenPlugin.Set3DEf fectMode(PL SCREEN 3DEFFECT MODE OFF): 
Example 
HT 1 = 
ScreenPlugin.Check3DEf fectMode(PL SCREEN 3DEFFECT. MODE. SIDE BY SIDE 
|: 
б5сгеепР | по! п. Зе! ЗОЕ fectMode(PL SCREEN ЗОЕЕРЕСТ MODE SIDE BY 
SIDE): 
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4.14.1.3. Flag3DEffectSupport 


Function 
Flag3DEffectSupport 


Flag3DEffectSupport function returns whether device supports 3DEffect or not 


Flag3DEffectSupport( ) 


Return If device supports 3DEffect, returns positive value 
Value otherwise, returns negative value 


Emulator 
Only returns false. 
remarks 


ІК 1 == ScreenPlugin.Flag3DEffectSupport() ) 
{ 
if PL SCREEN 3DEFFECT MODE SIDE BY SIDE == 
ScreenPlugin.Get3DEffectMode() ) 
{ 
Example 1 
ScreenPlugin.Check3DEffectMode(PL SCREEN 3DEFFECT MODE OFF), 
{ 
ScreenPlugin.Set3DEffectMode(PL SCREEN 3DEFFECT MODE OFF); 
) 
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if( 1 == 
ScreenPlugin.Check3DEffectMode(PL SCREEN 3DEFFECT MODE SIDE BY SI 
DE), 


ScreenPlugin.Set3DEffectMode(PL SCREEN 3DEFFECT MODE SIDE - 
BY. SIDE); 


Enumerati 
none 
on 


Support from SCREEN-0002 


Security 
Multimedia 
Type 


4.14.1.4. Get3DEffectMode 


Function 


Get3DEffectMode 


Get DEffectMode function returns a current 3DEffectMode (РІ, SCREEN 3DEFFECT MODE ) 
Syntax Get3DEffectMode( ) 


Return If success, returns a current 3DEffectMode (РІ, SCREEN 3DEFFECT MODE ) 


Value otherwise, returns negative value 


Remarks none 


Emulator 
Only returns РІ, SCREEN. 3DEFFECT MODE OFF 
remarks 


ІК 1 == ScreenPlugin.Flag3DEffectSupport() ) 


Example 
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if PL SCREEN 3DEFFECT MODE SIDE BY SIDE = 
ScreenPlugin.Get3DEffectMode() ) 
{ 
if( 1 == 
ScreenPlugin.Check3DEffectMode(PL SCREEN 3DEFFECT MODE OFF); 
{ 
ScreenPlugin.Set3DEffectMode(PL SCREEN 3DEFFECT MODE OFF); 
if( 1 == 
ScreenPlugin.Check3DEffectMode(PL_SCREEN_3DEFFECT_MODE_SIDE_BY_SI 
DE); 
ScreenPlugin.Set3DEffectMode(PL_SCREEN_3DEFFECT_MODE_SIDE_ 
BY_SIDE); 


PL_SCREEN_3DEFFECT_MODE 
on 


Support from SCREEN-0002 


Security 
Multimedia 
Type 


4.14.1.5. GetOption 


Function 


GetOption 


GetOption function returns a value for each а SCREEN, OPTION) 
| GetOption PL SCREEN OPTION option)... CT PL SCREEN OPTION option ) 
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e option 
о РІ, SCREEN OPTION 
Parameter 

o option 

If success, a value for each option(PL SCREEN OPTION) 

otherwise, returns negative value 

Return Value 
For detail return value, see PL SCREEN OPTION section. 


Emulator 
Only return true. 
remarks 


ІК 1 == ScreenPlugin.GetOption(PL SCREEN OPTION SHOP МОРЕ)) 


{ 
ScreenPlugin.GetOption(PL SCREEN OPTION SHOP MODE, 0) 


Example 


е PL SCREEN OPTION 
Enumeration 


Support from SCREEN-0002 
Security Type | TVInfo 


4.14,1.6. Set3DEffectMode 


Function 
Set3DEffectMode 


Set3DEffectMode function sets 3DEffect 


Set3DEffectMode( PL SCREEN 3DEFFECT MODE mode ) 


PL SCREEN 3DEFFECT MODE 
Parameter 
3DEffect mode 
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If success, returns positive value 
otherwise, returns negative value 
none 


Only returns false 


if( 1 == ScreenPlugin.Flag3DEffectSupport() ) 
{ 
if PL SCREEN 3DEFFECT MODE SIDE BY 5ШЕ == 
ScreenPlugin.Get3DEffectMode() ) 
{ 
if( 1 == 
ScreenPlugin.Check3DEffectMode(PL SCREEN 3DEFFECT MODE OFF), 
{ 


ScreenPlugin.Set3DEffectMode(PL SCREEN 3DEFFECT MODE OFF); 


if( 1 == 
ScreenPlugin.Check3DEffectMode(PL SCREEN 3DEFFECT MODE SIDE BY SI 
DE), 


ScreenPlugin.Set3DEffectMode(PL SCREEN 3DEFFECT MODE SIDE 
BY SIDE); 


е PL SCREEN 3DEFFECT MODE 


Support from SCREEN-0002 
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4.14.2. Enumeration 


4.14.2.1. РІ, SCREEN 3DEFFECT MODE 


Enumeration 
PL SCREEN 3DEFFECT MODE 


3D effect mode 


Emulator 
remarks 
Set3DEffectMode 
Get3DEffectMode 
Check3DEffectMode 


Function 


PL SCREEN 3DEFFECT MODE OFF 

PL SCREEN 3DEFFECT MODE TOP BOTTOM 

PL SCREEN 3DEFFECT MODE SIDE BY SIDE 

PL SCREEN 3DEFFECT MODE LINE BY LINE 

PL SCREEN 3DEFFECT MODE VERTICAL STRIPE 
PL SCREEN 3DEFFECT MODE FRAME SEQUENCE 
PL SCREEN 3DEFFECT MODE CHECKER BD 

PL SCREEN 3DEFFECT MODE FROM 2D TO 3D 


N NN Un ы о із жн > 


4.14.2.2. РІ, SCREEN OPTION 


Enumeration 
PL SCREEN OPTION 


screen option 


Remarks 


Emulator 


remarks 
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GetOption 
Function SetOption 


3 - PL SCREEN OPTION SHOP MODE 
o value : Shop mode(1), Home mode(0) 
36 - PL SCREEN OPTION FIXED FRAME RATE 
Value o value: fixed(1), non-fixed(0) 
41 - PL SCREEN OPTION BRIGHTNESS SENSOR 
o value: on(1), off(0) 


4.15. TV 

4.15.1. Function 
4.15.1.1. CheckPIP 

Function 


CheckPIP 


CheckPIP function return whether you can change PIP state or not 


CheckPIP( Number IsOn ) 


e  IsOn 
o Number 
Parameter 
o On:1,0ff:0 


If you can change PIP state to IsOn value, returns 1, 
Return Value If you can't cahnge, returns 0, 
If function fails, returns negative value 


Emulator remarks | Only returns false 


ІШІ == TVPlugin.GetPIP() ) 
{ 
if( 0 < TVPlugin.CheckPIP(0) ) 
Example | 
TVPlugin.SetPIP(0); 
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BEE 


Support from TV-0003 
Security Type TVInfo 


4.15.1.2. FlagStreamDST 


Function 


FlagStreamDST 


FlagStreamDST function returns DST(Daylight Saving Time) on/off information from a current stream 
If success, returns positive value. 
Return Value 
otherwise, returns negative value 
Emulator remarks | Only returns false 


ETE TVPlugin.FlagStreamDST(); 
Example 


Support from TV-0001 
Security Type TVInfo 


4.15.1.3. GetBDProductType 


Function 


GetBDProductType 


GetBDProductType function returns a BD product type ( Single or HTS or ... ) 
GetBDProductType( ) 


If success, returns a target location. (PL TV BDPRODUCT TYPE) 


Return Value : | 
otherwise, returns negative value 


Remarks 
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Emulator remarks | [Fake] returns PL TV BDPRODUCT TYPE SINGLE 


if PL TV BDPRODUCT TYPE SINGLE == 
TVPlugin.GetBDProductType() ) 
Example | 


) е РІ, ТУ BDPRODUCT TYPE 
7Enumeration 


Support from TV-0007 
Security Type TVInfo 


4.15.1.4. GetCountry 


Function 
GetCountry 


GetCountry function returns a current country information 


If success, returns a current country information. (PL TV COUNTRY) 
Return Value 
otherwise, returns negative value 
This function replace same name function of TVMW plugin 

Emulator 
none 

remarks 
alert(" SetCountry = " + TVPlugin.SetCountry(PL TV COUNTRY USA)); 
alert(" SetLanguage = " + 


TVPlugin.SetLanguage(PL TV LANGUAGE ЕКА US)): 


Example 


alert("Country = " + TVPlugin.GetCountry()); 
alert("Language = " + TVPlugin.GetLanguage()); 


. е PL TV COUNTRY 
Enumeration 


Support from TV-0001 
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Security Type TVInfo 


4.15.1.5. GetDisplayPanelType 


Function 


GetDisplayPanelType 


GetDisplayPanelType function returns a display panel type (LCD or LED ... ) 


GetDisplayPanelType( ) 


If success, returns a display panel type. (PL. TV DISPLAY PANEL) 
Return Value 
otherwise, returns negative value 


This function replace same name function of Device plugin 


Emulator 
none 
remarks 


if( TVPlugin.GetDisplayPanelType() == PL TV DISPLAY PANEL РОР); 
{ 
Example ET 


e РІ, ТУ DISPLAY PANEL 
Enumeration 


Support from TV-0004 
Security Type TVInfo 


4.15.1.6. GetDST 


Function 
GetDST 


GetDST function returns a current DST(Daylight Saving Time) type 


If success, returns a current DST Type. (PL TV DST TYPE) 
Return Value 
otherwise, returns negative value 


@Samsung Electronics Copyright All Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


Emulator remarks | Oly returns false 


ETE TVPlugin.GetDST(): 
Example 


Enumeration 


Support from TV-0001 
Security Type TVInfo 


4.15.1.7. GetLanguage 


Function 


GetLanguage 


GetLanguage function returns a language information 


If success, returns a language information. (PL_TV_LANGUAGE) 
Return Value 
otherwise, returns negative value 


This function replace same name function of TVMW plugin 


Emulator 
none 
remarks 


alert("SetCountry = " + TVPlugin.SetCountry(PL_TV_COUNTRY_USA)); 


alert("SetLanguage = " + 
TVPlugin.SetLanguage(PL_TV_LANGUAGE_FRA_US)); 


Example 
alert("Country = " + TVPlugin.GetCountry()); 
alert( Language = " + TVPlugin.GetLanguage()); 


e РІ, ТУ LANGUAGE 
Enumeration 


Support from TV-0001 
Security Type TVInfo 
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4.15.1.8. GetLanguageSet 


Function 


GetLanguageSet 


GetLanguageSet function returns a language set 


If success, returns a language set. (PL TV FACTORY LANGUAGE) 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator 
none 
remarks 
alert( "TVPlugin.GetLanguageSet() = " + TVPlugin.GetLanguageSet()); 
Example 
“ PL ТУ FACTORY. LANGUAGE 
Enumeration 


Support from TV-0009 
Security Type TVInfo 


4.15.1.9. GetPIP 


Function 
GetPIP 


GetPIP function return current PIP state(On or Off) 


If PIP is on, returns 1, 
Return Value If PIP is off, returns 0, 
If function fails, returns negative value 


Emulator remarks | Only returns false 


if( 1 == TVPlugin.GetPIP() ) 
Example ( 
if( 0 < TVPlugin.CheckPIP(0) ) 
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әр TVPlugin.SetPIP(0); 


Support from TV-0003 
Security Type TVInfo 


4.15.1.10.  GetPresentProgram Duration 


Function 
GetPresentProgram Duration 


GetPresentProgram Duration function returns duration(sec) of current program 


GetPresentProgram Duration( ) 
If success, returns duration(sec) of current program 
Return Value | . 
otherwise, returns negative value 


Emulator . | я 
Returns duration of current program in a virtual channel. 
remarks 


var title = TV Plugin.GetPresentProgram_Title(); 

var startTime = 

TimePlugin.ConvertEpochToLocalTime(TVPlugin.GetPresentProgram StartTime()): 
Example var endTime - 

TimePlugin.ConvertEpochToLocalTime(TVPlugin.GetPresentProgram EndTime()); 

var duration = TVPlugin.GetPresentProgram, Duration(); 


Support from TV-0001 


Security 
Channel 
Type 
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4.15.1.11. GetPresentProgram EndTime 


Function 


GetPresentProgram EndTime 


GetPresentProgram EndTime function returns end time(UTC) of current program 
GetPresentProgram EndTime( ) 


If success, returns end time(UTC) of current program 
Return Value . . 
otherwise, returns negative value 


Emulator 


Returns end time of current programe in a virtual channel 


remarks 


var title - TVPlugin.GetPresentProgram Title(); 

var startTime — 

TimePlugin.ConvertEpochToLocalTime(TVPlugin.GetPresentProgram StartTime()); 
Example var endTime - 

TimePlugin.ConvertEpochToLocalTime(TVPlugin.GetPresentProgram_EndTime()); 

var duration = TVPlugin.GetPresentProgram, Duration(); 


Support from TV-0001 


Security 
Channel 
Type 


4.15.1.12.  GetPresentProgram StartTime 


Function 


GetPresentProgram StartTime 


GetPresentProgram StartTime function returns start time(UTC) of current program 
GetPresentProgram StartTime( ) 


If success, returns start time(UTC) of current program 


Return Value : : 
otherwise, returns negative value 


Remarks 
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Emulator . ; | 
Returns start time of current program in a virtual channel. 
remarks 


var title = TVPlugin.GetPresentProgram Title): 

var startTime - 

TimePlugin.ConvertEpochToLocalTime(TV Plugin.GetPresentProgram StartTime()); 
Example var endTime - 

TimePlugin.ConvertEpochToLocalTime(TV Plugin.GetPresentProgram, EndTimer()); 

var duration 2 TVPlugin.GetPresentProgram, Duration(); 


Support from TV-0001 


Security 
Channel 
Type 


4.15.1.13. GetPresentProgram Title 


Function 


GetPresentProgram Title 


GetPresentProgram Title function returns title of current program 
Syntax GetPresentProgram Title( ) 


If success, returns title of current program 
Return Value . . 
otherwise, returns negative value 


Remarks 


Emulator . Е Е 
Returns a title of current program іп a virtual channel. 
remarks 


var title = TVPlugin.GetPresentProgram Title): 


var startTime - 

TimePlugin.ConvertEpochToLocalTime(TV Plugin.GetPresentProgram StartTime()); 
Example var endTime = 

TimePlugin.ConvertEpochToLocalTime(TVPlugin.GetPresentProgram_EndTime()); 


var duration = TVPlugin.GetPresentProgram_Duration(); 


@Samsung Electronics Copyright All Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


Version Support from TV-0001 


Security 
Channel 


Type 


4.15.1.14.  GetProductCode 


Function 


GetProductCode 


GetProductCode function returns a product code ( ex: UNNOC7000 ) 


GetProductType ( NUMBER region ) 


e region 
о “NUMBER 
Parameter 
o Гада" [region] ", 0:No region 


If success, returns a target location. (UNNOC7000 or UNNOC7000. USA) 
Return Value 
otherwise, returns negative value 


Emulator 
[Fake] Returns LN40B650 KOR 
remarks 


if( UNNOC7000 USA" == TVPlugin.GetProductCode(1) ) 
{ 
Example ди 


Support from ТУ-0007 
Security Type 


4.15.1.15.  GetProductType 


Function 


GetProductType 


GetProductType function returns a product type (TV or BD or Mornitor ...) 
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If success, returns a product type. (PL TV PRODUCT ТҮРЕ) 
Return Value 
otherwise, returns negative value 


Emulator 


[Fake]Returns РІ, TV PRODUCT TYPE ТУ 


remarks 


if PL TV PRODUCT ТҮРЕ BD == TVPlugin.GetProductType() ) 
| 
Example er 


e PL TV PRODUCT TYPE 
Enumeration 


Support from ТУ-0004 
Security Туре 


4.15.1.16.  GetProgram Duration 


Function 
GetProgram Duration 


GetProgram Duration function returns duration(sec) of program at input index 


GetProgram Duration( Number index ) 


o Number 


o index on program list made by GetProgramList function 


Emulator . . . : . 
Returns duration of program at input index in a virtual channel 
remarks 


var epochTime - TimePlugin.GetEpochTime(); 


Example 
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TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize - TVPlugin.GetProgramList Size(): 
if( programListSize > 5 ) 
{ 
programListSize = 5; 
for(var 1=0 ; i<programListSize ; ++i) 
{ 
document.getElementB yId( Те" + i).value = 
TVPlugin.GetProgram Title(1); 
document.getElementByld('Start' + 1).уаше = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram StartTime(1) ); 
document.getElementB yId('End' + 1).value = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 
document.getElementB yId('Duration' + 1).уаше = 
TVPlugin.GetProgram Duration(1): 
) 


Support from ТУ-0001 
Security Туре 


4.15.1.17. GetProgram EndTime 


Function 
GetProgram EndTime 


GetProgram EndTime function returns end time(UTC) of program at input index 


GetProgram EndTime( Number index ) 


e index 
o Number 
Parameter 
o index on program list made by GetProgramList function 
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If success, returns end time(UTC) of program at input index 
Return Value . . 
otherwise, returns negative value 


Emulator . . . . . 
Returns end time of program at input index in a virtual channel. 
remarks 


var epochTime = TimePlugin.GetEpochTime(); 


TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize = TVPlugin.GetProgramList Size(); 


Ш programListSize > 5 ) 
{ 


programListSize = 5; 


for(var 1=0 ; i<programListSize ; ++i) 
Example | 
document.getElementB yId( Те" + 1).уаше = 
TVPlugin.GetProgram Title(1), 
document.getElementB yId('Start' + 1).уаше = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram StartTime(1) ); 


document.getElementB yId('End' + 1).value = 


TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 


document.getElementB yId('Duration' + i).value = 


TVPlugin.GetProgram Duration(1): 
) 


Support from ТУ-0001 
Security Type 


4.15.1.18.  GetProgram StartTime 


Function 


GetProgram StartTime 
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GetProgram StartTime function returns start time(UTC) of program at input index 


| GetProgram_StartTime( Number index) | StartTime( | GetProgram_StartTime( Number index) | index ) 


e index 
o Number 
Parameter 
o index on program list made by GetProgramList function 


If success, returns start time(UTC) of program at input index 
Return Value 
otherwise, returns negative value 


Emulator 
Returns start time of program at input index in a virtual channel. 
remarks 


var epochTime - TimePlugin.GetEpochTime(); 


TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize = TVPlugin.GetProgramList Size(); 


if( programListSize > 5 ) 
{ 


programListSize = 5; 


for(var 1=0 ; i<programListSize ; ++i) 
Example ( 
document.getElementB yId('Title' + i).value = 
TVPlugin.GetProgram_Title(i); 
document.getElementByld('Start' + i).value = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_StartTime(i) ); 
document.getElementB yId('End' + i).value = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 
document.getElementB yId('Duration' + i).value = 


TVPlugin.GetProgram_Duration(i); 
} 
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Version Support from TV-0001 


Security Type 


4.15.1.19. GetProgram Title 


Function 
GetProgram Title 


GetProgram Title function returns title of program at input index 


GetProgram Title( Number index ) 


e index 
o Number 
Parameter 
o index оп program list made by GetProgramList function 


If success, returns title of program at input index 
Return Value . . 
otherwise, returns negative value 


Emulator : : . . . 
Returns title of program at intput index in a virtual channel 
remarks 


var epochTime - TimePlugin.GetEpochTime(); 
TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize = TVPlugin.GetProgramList Size(); 
if( programListSize > 5 ) 
{ 
programListSize = 5; 
Ехатріе 
for(var 1=0 ; i<programListSize ; ++i) 
{ 
document.getElementB yId('Title' + i).value = 
TVPlugin.GetProgram_Title(i); 
document.getElementByld('Start' + i).value = 
TimePlugin.ConvertEpochToLocalTime( TV Plugin.GetProgram_StartTime(i) ); 
document.getElementB yId('End' + i).value = 
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TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram EndTimef(1) ); 
document.getElementB yId('Duration' + i).value = 

TVPlugin.GetProgram Duration(1): 

) 


Support from ТУ-0001 
Security Туре 


4.15.1.20.  GetProgramList 


Function 
GetProgramL ist 


GetProgramList function make program list of input time 


GetProgramList( Number startTime , Number duration ) 


e  startTime 
o Number 
о Start time to search(UTC) 
Parameter e duration 
o Number 


o Duration from startTime(sec) 


If success, returns positive value 
Return Value . . 
otherwise, returns negative value 


Remarks 


Emulator 


Make program list of intput time with a virtual channel. 


remarks 


var epochTime = TimePlugin.GetEpochTime(); 
TVPlugin.GetProgramList(epochTime, 3600); 

Example var programListSize = TVPlugin.GetProgramList Size(); 
if( programListSize > 5 ) 
{ 
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programListSize - 5; 


for(var 1-0 ; i<programListSize ; ++i) 
{ 
document.getElementB yId( Title' + 1).уаше = 
TVPlugin.GetProgram_Title(i); 
document.getElementByld('Start' + i).value = 


TimePlugin.ConvertEpochToLocalTime( TV Plugin.GetProgram_StartTime(i) ); 


document.getElementB yId('End' + i).value = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 
document.getElementB yId('Duration' + i).value = 


TVPlugin.GetProgram_Duration(i); 
} 


Support from TV-0001 
Security Type 


4.15.1.21.  GetProgramList Size 


Function 
GetProgramList Size 


GetProgramList Size function returns size of program list 


GetProgramList Size( ) 


If success, returns return size of program list 
Return Value : . 
otherwise, returns negative value 
Remarks 


Emulator 

Returns size of program list made with a virtual channel. 
remarks 

var epochTime = TimePlugin.GetEpochTime(); 
Example 
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TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize - TVPlugin.GetProgramList Size(): 
if( programListSize > 5 ) 
{ 
programListSize = 5; 
for(var 1=0 ; i<programListSize ; ++i) 
{ 
document.getElementB yId( Те" + 1).уаше = 
TVPlugin.GetProgram Title(1); 
document.getElementB yId('Start' + 1).уаше = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram StartTime(1) ); 
document.getElementB yId('End' + 1).value = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 
document.getElementB yId('Duration' + 1).уаше = 
TVPlugin.GetProgram Duration(1): 
) 


Support from ТУ-0001 
Security Type | Channel 


4.15.1.22.  GetTargetLocation 


Function 
GetTargetLocation 


GetTargetLocation function returns a target location (KOR or USA ...) 


GetTargetLocation( ) 


Parameter none 


If success, returns a target location. (РІ, TV TARGET LOCATION) 


Return Value . . 
otherwise, returns negative value 


Remarks 
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Emulator 
[Fake]Returns PL TV TARGET LOCATION UNKNOWN 


remarks 


if PL ТУ TARGET LOCATION, USA == TVPlugin.GetTargetLocation() ) 
{ 
Example si 


“ РІ, TV TARGET LOCATION 
Enumeration 


Support from TV-0005 
Security Type TVInfo 


4.15.1.23. | GetTimeZone 


Function 
GetTimeZone 


GetTimeZone function returns a timezone(PL_TV_TIMEZONE) 


If success, returns a timezone(PL_TV_TIMEZONE) 
Return Value 
otherwise, returns negative value 
Emulator remarks | Only returns false 


TVPlugin.GetTimeZone(); 
Example 
Enumeration 


Support from TV-0001 
Security Type TVInfo 


4.15.1.24. GetTimeZone Offset 


Function 


GetTimeZone Offset 
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GetTimeZone Offset function returns a offset of timezone(PL TV TIMEZONE) 
GetTimeZone Offset( ) 


If success, returns a offset of timezone(PL TV TIMEZONE) 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator remarks | Only returns false 


ETE TVPlugin.GetTimeZone Offset(): 
Example 


Support from TV-0001 
Security Type TVInfo 


4.15.1.25.  SetEvent 


Function 
SetEvent 


SetEvent function registers event to receive callback 


SetEvent( PL TV EVENT event ) 


e event 
о PL TV EVENT 
Parameter 
o Event to register 


If success, returns positive value 
Return Value 


otherwise, returns negative value 


Remarks 


Emulator 


Supports only PL TV EVENT CHANNEL CHANGE and PL TV EVENT TUNE SUCCESS. 
remarks 


function OnLoadFunc() 
{ 

T TVPlugin.SetEvent(PL TV EVENT CHANNEL CHANGED); 
TVPlugin.SetEvent(PL TV EVENT NO SIGNAL); 
TVPlugin.SetEvent(PL TV EVENT TUNE SUCCESS); 
TVPlugin.SetEvent(PL TV EVENT PROGRAM CHANGED); 
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TVPlugin.OnEvent = OnEvent; 
function OnUnloadFunc() 
{ 
TVPlugin.UnsetEvent(PL TV EVENT CHANNEL CHANGED), 
TVPlugin.UnsetEvent(PL TV EVENT МО SIGNAL): 
TVPlugin.UnsetEvent(PL TV EVENT TUNE SUCCESS), 
TVPlugin.UnsetEvent(PL TV EVENT PROGRAM CHANGED); 
function OnEvent(id) 
{ 
switch( parselnt(id) ) 
{ 
case РІ, TV EVENT TUNE SUCCESS: 
{ 
UpdateChannelData(); 
break; 
) 
case PL ТУ EVENT PROGRAM CHANGED: 
{ 
UpdateProgramData(); 
break; 


Enumeration 


Support from TV-0001 
Security Type | TVInfo 


4.15.1.26.  SetPIP 
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Function 
SetPIP 


SetPIP function turn on or off PIP State 


SetPIP( Number IsOn ) 


e [Оп 
o Number 
Parameter 
o On:1,0ff:0 


If success, returns positive value. 
Return Value . | 
otherwise, returns negative value 


Remarks 


Emulator remarks | Returns only false 


ІШІ == TVPlugin.GetPIP() ) 

{ 
if( 0 < TVPlugin.CheckPIP(0) ) 
{ 


Example 


TVPlugin.SetPIP(0); 


Support from TV-0003 
Security Type TVInfo 


4.15.1.27. UnsetEvent 


Function 


UnsetEvent 


UnsetEvent function cancels event registration 


UnsetEvent( PL TV EVENT event ) 


e event 
Parameter 
o PL TV EVENT 
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MEN o Event to cancel registration 
If success, returns positive value 
Return Value . . 
otherwise, returns negative value 
Remarks 


Emulator 
Е Supports only PL TV EVENT CHANNEL CHANGE and PL TV EVENT TUNE SUCCESS. 
remarks 


function OnLoadFunc() 
{ 
TVPlugin.SetEvent(PL TV EVENT CHANNEL CHANGED); 
TVPlugin.SetEvent(PL TV EVENT NO SIGNAL); 
TVPlugin.SetEvent(PL TV EVENT TUNE SUCCESS); 
TVPlugin.SetEvent(PL TV EVENT PROGRAM CHANGED); 
TVPlugin.OnEvent - OnEvent; 
function OnUnloadFunc() 
{ 
TVPlugin.UnsetEvent(PL TV EVENT CHANNEL CHANGED), 
TVPlugin.UnsetEvent(PL TV EVENT NO SIGNAL); 
TVPlugin.UnsetEvent(PL TV EVENT TUNE SUCCESS); 
Example TVPlugin.UnsetEvent(PL TV EVENT PROGRAM CHANGED); 
function OnEvent(id) 
{ 
switch( parselnt(id) ) 
| 
case PL ТУ EVENT TUNE SUCCESS: 
{ 
UpdateChannelData(); 
break; 
) 
case РІ, TV EVENT PROGRAM CHANGED: 
{ 
UpdateProgramData(); 
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Enumeration 


Support from TV-0001 
Security Type | TVInfo 


4.15.2. Enumeration 


4.15.2.1. PL TV BDPRODUCT TYPE 


Enumeration 


PL TV BDPRODUCT TYPE 


Bluray Disc Product type 


Remarks 


Emulator 


remarks 


tBDProductT 


0 - PL TV BDPRODUCT TYPE UNKNOWN 
1- РІ, ТУ BDPRODUCT TYPE SINGLE 

2 - PL TV BDPRODUCT TYPE HTS 

3 - PL TV BDPRODUCT TYPE HDD 


4.15.2.2. PL TV COUNTRY 


Enumeration 


PL TV COUNTRY 


Country 
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Emulator 


remarks 


Function 


SetCountry 


GetCountry 
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РІ, ТУ COUNTRY USA 

РІ, ТУ COUNTRY КОК 

РІ, ТУ СОСМТКҮ 5РА 

РІ, ТУ COUNTRY ЕКА 

РІ, ТУ COUNTRY JPN 

РІ, ТУ COUNTRY EU 

РІ, ТУ COUNTRY UK 

РІ, ТУ COUNTRY GERMANY 

РІ, ТУ COUNTRY ITALY 

РІ, ТУ COUNTRY SWEDEN 
РІ, TV COUNTRY BULGARIA 
PL TV COUNTRY CROATIA 
PL TV COUNTRY CZECH 
PL TV COUNTRY NETHERLANDS 
PL TV COUNTRY GREECE 
PL TV COUNTRY HUNGARY 
PL TV COUNTRY POLAND 
PL TV COUNTRY PORTUGAL 
PL TV COUNTRY ROMANIA 
PL TV COUNTRY RUSSIA 
PL TV COUNTRY SWITZERLAND 
PL TV COUNTRY TURKEY 
PL TV COUNTRY AUSTRALIA 
PL TV COUNTRY AUSTRIA 
PL TV COUNTRY BELGIUM 
PL TV COUNTRY DENMARK 
PL TV COUNTRY FINLAND 
PL TV COUNTRY NORWAY 
PL TV COUNTRY CHINA 
PL TV COUNTRY IRELAND 
PL TV COUNTRY SERBIA 
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PL TV COUNTRY SAN MARINO 

PL TV COUNTRY MONACO 

PL TV COUNTRY BRAZIL 

PL TV COUNTRY HONGKONG 

PL TV COUNTRY TAIWAN 

PL TV COUNTRY NEWZEALAND 

PL TV COUNTRY SLOVAKIA 

PL TV COUNTRY SINGAPORE 

PL TV COUNTRY GENERALCABLE 

PL TV COUNTRY NORTH AFRICA 

PL TV COUNTRY BELGIUM, FRENCH 

PL TV COUNTRY BELGIUM, DUTCH 

PL TV COUNTRY SOUTH, AFRICA 

PL TV COUNTRY OTHER 

PL TV COUNTRY ASIAWEUROPE ANALOG 
PL TV COUNTRY HONGKONG UK ANALOG 
PL TV COUNTRY NZL INDONESIA ANALOG 
PL TV COUNTRY SOUTH, AFRICA ANALOG 
PL TV COUNTRY AMERICA ANALOG 

PL TV COUNTRY CHINA ANALOG 

PL TV COUNTRY EASTEUROPE ANALOG 


4.15.2.3. PL TV DISPLAY PANEL 


Enumeration 


PL TV DISPLAY PANEL 


Display panel 


Emulator 
none 
remarks 
е GetDisplayPanelType 
e 0- PL TV DISPLAY PANEL LCD 
Value 
е 1- PL TV DISPLAY PANEL РОР 
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PL TV DISPLAY PANEL DLP 
PL TV DISPLAY PANEL LED 
PL TV DISPLAY PANEL LED EDGE 


PL TV DISPLAY PANEL LED DIRECT 
PL TV DISPLAY PANEL CRT 


4.15.2.4. PL TV DST TYPE 


Enumeration 
PL ТУ DST TYPE 


DST(Daylight Saving Time) type 


Remarks 


Emulator 
remarks 


SetDST 
Function GetDST 


0 - PL TV DST TYPE OFF 
1 - PL TV DST TYPE ON 
2 - PL TV DST TYPE AUTO 


4.15.2.5. PL TV EVENT 


Enumeration 
PL TV EVENT 


Event 


Remarks none 


Emulator 


remarks 


е  SetEvent 


Function e  UnsetEvent 
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PL TV EVENT NO SIGNAL 
When no signal 
PL TV EVENT TUNE CHANNEL 
When start channel tuning 
PL TV EVENT TUNE SUCCESS 
When channel tune success 
PL TV EVENT BACKGROUND SIGNAL OK 
Not supported 
PL TV EVENT SEARCH, CHANNEL 
When start seraching channel ( for each channel number ) 
PL TV EVENT CHANNEL FOUND 
When channel is found 
PL TV EVENT CHANNEL FOUND LIST 
Not supported 
PL TV EVENT SEARCH CHANNEL DONE 
When finish searching channel 


PL TV EVENT SEARCH CHANNEL MAP FULL 


When channel search is be terminated since channel map is full when channel 
search. 
PL TV EVENT NOT SUPPORTED 
When channel signal is not supported signal 
PL TV EVENT MTS CHANGED 
When MTS is changed 
PL TV EVENT CHANNEL MAP CHANGED 
o When channel map is changed because stream information is changed 
113 - PL TV EVENT CHANNEL CHANGED 
o “When channel is changed 


114 - PL TV EVENT SOURCE CHANGED 


o When source is changed 

115 - PL TV EVENT CHANGE ТУ MODE 
o When TV mode is changed 

116 - PL TV EVENT SETCHANNEL TUNED 


o When setchannel command is finished 
117 - PL TV EVENT RESOLUTION CHANGED 
o When resolution is changed 


118 - PL TV EVENT RESOLUTION DETECTED 
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Not supported 
PL TV EVENT EXTSOURCE SCART 
SCART Plug, Unplug event 
PL TV EVENT UPDATE DYNAMICSI 
Not supported 
PL TV EVENT SEARCH GET NETWORK DONE 
Not supported 
PL TV EVENT HD NOT SUPPORT 
Not supported 
PL TV EVENT SHOW START 
This triggers mute-off when tuner tunes to DTV. 
PL TV EVENT SOURCE CONNECTED 


When a source is connected in source changing procedure. 


PL TV EVENT EPG COMPLETED 
When all EPG information is received 

PL TV EVENT EPG CHANGED 
When EIT is changed 

PL TV EVENT CAPTION DESCRIPTOR 
When caption descriptor is received 

PL TV EVENT PROGRAM CHANGED 
When current program is changed 

PL TV EVENT STREAM CLOCK CHANGED 
When system clock is changed 

PL TV EVENT SW UPGRADE 
When USB S/W update is started 

PL TV EVENT PMT ARRIVED 
Not supported 

PL TV EVENT DSIDII ARRIVED 
Not supported 

PL TV EVENT DDB ARRIVED 
Not supported 

PL TV EVENT TSD ARRIVED 
Not supported 

PL TV EVENT CHANGE POWER STATE 


Not supported 
PL TV EVENT RECV CURRENT EVENT 
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4.15.2.6. 


Not supported 
PL TV EVENT STT CHANGED 


Not supported 


PL TV EVENT CAPTION MODE CHANGED 
When caption mode is changed 
PL TV EVENT PROGRAM CHANGED MULTIPLEX 
[Not supported] Program changed event with service information in current 
mux(DVB) 
PL TV EVENT DVBSI STARTED 
Not supported 
PL TV EVENT PRESENT EIT CHANGED 
Not supported 


PL TV FACTORY LANGUAGE 


Enumeration 


PL TV FACTORY LANGUAGE 


Factory language 


Emulator 


remarks 


none 


none 


GetL Set 
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- РІ, ТУ FACTORY LANGUAGE UNKNOWN 

РІ, ТУ FACTORY LANGUAGE EAST ASIA 

PL TV FACTORY LANGUAGE IRAN 

PL TV FACTORY LANGUAGE ISRAEL 

PL TV FACTORY LANGUAGE MIDDLE ASIA 

PL TV FACTORY LANGUAGE SOUTH AMERICA 
PL TV FACTORY LANGUAGE TAIWAN 

PL TV FACTORY LANGUAGE AFRICA 

PL TV FACTORY LANGUAGE NORTH AFRICA 
PL TV FACTORY LANGUAGE WEST ASIA 
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4.15.2.7. PL TV LANGUAGE 


Enumeration 
PL TV LANGUAGE 


Language 


Remarks 


Emulator 


remarks 


SetLanguage 
Function GetLanguage 


PL TV LANGUAGE KOR 
PL TV LANGUAGE ENG US 
PL TV LANGUAGE SPA US 
PL TV LANGUAGE FRA US 
PL TV LANGUAGE POR US 
PL TV LANGUAGE BUL 
PL TV LANGUAGE CRO 
PL TV LANGUAGE CZE 
PL TV LANGUAGE DAN 
PL TV LANGUAGE DUT 
PL TV LANGUAGE FIN 
PL TV LANGUAGE FRA 
PL TV LANGUAGE DEU 
PL TV LANGUAGE GRE 
PL TV LANGUAGE HUN 
PL TV LANGUAGE ITA 
PL TV LANGUAGE NOR 
PL TV LANGUAGE ENG 
PL TV LANGUAGE POL 
PL TV LANGUAGE POR 
PL TV LANGUAGE ROM 
PL TV LANGUAGE RUS 
PL TV LANGUAGE SER 
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PL TV LANGUAGE SLK 
PL TV LANGUAGE SPA 
PL TV LANGUAGE SWE 
PL TV LANGUAGE TUR 
PL TV LANGUAGE CHI 
PL TV LANGUAGE HKG 
PL TV LANGUAGE TPE 
PL TV LANGUAGE JPN 
PL TV LANGUAGE MAO 
PL TV LANGUAGE CMN 
PL TV LANGUAGE YUE 
PL TV LANGUAGE HIN 
PL TV LANGUAGE EST 
PL TV LANGUAGE LAT 
PL TV LANGUAGE LTU 
PL TV LANGUAGE ARA 
о Arab 
- PL TV LANGUAGE PER 


o Farsi 
PL TV LANGUAGE QAA 
PL TV LANGUAGE AD 
PL TV LANGUAGE CAT 
PL TV LANGUAGE VAL 
PL TV LANGUAGE THA 
o Thai 

45 - PL TV LANGUAGE HEB 
o Hebrew 

46 - PL TV LANGUAGE IND 
o Indonesia 

47 - PL TV LANGUAGE VIE 
o Vietnamese 

48 - PL TV LANGUAGE URD 
o Urdu 

49 - PL TV LANGUAGE AFR 
o Afrikaans 


50 - PL TV LANGUAGE ZUL 
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o Zulu 
- PL TV LANGUAGE XHO 
o Xhosa 
- PL TV LANGUAGE YOR 
o  Yoruba 


- PL TV LANGUAGE IGB 


o Igbo 


- PL TV LANGUAGE HAU 
o Hausa 
- PL TV LANGUAGE SWA 
o Swahili 
- PL TV LANGUAGE AMH 
o Amharic 
- PL TV LANGUAGE OTHER 


4.15.2.8. PL TV PRODUCT TYPE 


Enumeration 
PL TV PRODUCT TYPE 


Product type 


Remarks 


Emulator 


remarks 


Се! Ргодис Г. 


0 - PL ТУ PRODUCT ТҮРЕ ТУ 
1 - PL ТУ PRODUCT ТҮРЕ MONITOR 
2 - РІ, ТУ PRODUCT ТҮРЕ ВО 


4.15.2.9. РІ, ТУ TARGET LOCATION 


Enumeration 


PL TV TARGET LOCATION 
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Target location 


Emulator 
none 
remarks 
GetTargetLocation 
Function 


PL TV TARGET LOCATION UNKNOWN 
PL TV TARGET LOCATION KOR 
PL TV TARGET LOCATION USA 
PL TV TARGET LOCATION BRA 
PL TV TARGET LOCATION PANEURO 
PL TV TARGET LOCATION CHI 
PL TV TARGET LOCATION HKG 
PL TV TARGET LOCATION ARB 
PL TV TARGET LOCATION PANNORDIG 
Value PL TV TARGET LOCATION SOUTHEASTASIA 
10 - РІ, ТУ TARGET LOCATION, ASIA АТУ 
11 - PL TV TARGET LOCATION, ASIA DTV 
12 - РІ, ТУ TARGET LOCATION TW 
13 - РІ, ТУ TARGET LOCATION NORTHAFRICA 
14 - РІ, ТУ TARGET LOCATION EA DTV 
15 - РІ, ТУ TARGET LOCATION CIS 
16 - РІ, ТУ TARGET LOCATION PHI 
17 - РІ, ТУ TARGET LOCATION S АЕК DTV 


4.15.2.10. PL TV TIMEZONE 


0 - 
1 
2 
3 
4 
5 
6 
7 
8 
9 


Enumeration 


PL TV TIMEZONE 


Time zone 


Remarks 


Emulator 
none 
remarks 
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SetTimeZone 


Function GetTimeZone 


PL TV TIMEZONE NEWFOUNDLAND 
о ATSC USA NEWFOUNDLAND 
PL ТУ TIMEZONE ATLANTIC 
o ATSC USA ATLANTIC 
PL TV TIMEZONE EASTERN 
о ATSC USA EASTERN 
PL TV TIMEZONE CENTRAL 
о ATSC USA CENTRAL 
PL TV TIMEZONE MOUNTAIN 
o ATSC USA MOUNTAIN 
PL TV TIMEZONE PACIFIC 
o ATSC USA PACIFIC 
PL TV TIMEZONE ALASKA 
о ATSC USA ALASKA 
PL TV TIMEZONE HAWAII 
о ATSC USA HAWAII 
100 - PL TV TIMEZONE SEOUL 
о ATSC KOR 
200 - PL ТУ TIMEZONE REGION 0 
DVB Time Zone Offset (Region 0) - Australia : Use in а contury that don't have 
multi time zone 
РІ, ТУ TIMEZONE REGION 1 
DVB Time Zone Offset (Region 1) - Australia : reserved , Spain 
PL TV TIMEZONE REGION 2 
DVB Time Zone Offset (Region 2) - Australia : New Southwales/ACT , Spain 
PL TV TIMEZONE REGION 3 
DVB Time Zone Offset (Region 3) - Australia : Victoria 
PL TV TIMEZONE REGION 4 
DVB Time Zone Offset (Region 4) - Australia : Queensland 
PL TV TIMEZONE REGION 5 
DVB Time Zone Offset (Region 5) - Australia : South Australia 
PL TV TIMEZONE REGION 6 
DVB Time Zone Offset (Region 6) - Australia : Western Australia 
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207 - РІ, ТУ TIMEZONE, REGION 7 


o DVB Time Zone Offset (Region 7) - Australia : Tasmania 


208 - PL TV TIMEZONE, REGION 8 
o DVB Time Zone Offset (Region 8) - Australia : Northern Territory 


4.15.3.1. OnEvent 


Event 
OnEvent 


Use OnEvent when you receive basic еуеп(РІ, TV EVENT) from TV plugin 


e  eventID 
o PL TV EVENT 
Parameter 
o eventID 


Remarks 


Emulator 
remarks 


function OnLoadFunc() 

{ 
TVPlugin.SetEvent(PL TV EVENT CHANNEL CHANGED); 
TVPlugin.SetEvent(PL TV EVENT МО SIGNAL); 
TVPlugin.SetEvent(PL TV EVENT TUNE SUCCESS); 
TVPlugin.SetEvent(PL TV EVENT PROGRAM CHANGED); 
TVPlugin.OnEvent = OnEvent; 

Example 

function OnUnloadFunc() 

{ 
TVPlugin.UnsetEvent(PL TV EVENT CHANNEL CHANGED): 
TVPlugin.UnsetEvent(PL TV EVENT КО SIGNAL): 
TVPlugin.UnsetEvent(PL TV EVENT TUNE SUCCESS); 
TVPlugin.UnsetEvent(PL TV EVENT PROGRAM CHANGED); 
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function OnEvent(id) 
{ 


switch( parseInt(id) ) 
{ 
case РІ, ТУ EVENT TUNE SUCCESS: 
{ 
UpdateChannelData(); 
break; 
} 
case РІ, TV EVENT PROGRAM CHANGED: 
{ 
UpdateProgramData(); 
break; 


4.16. TVMW 
4.16.1. Function 


4.16.1.1. CheckReservedKey 


Function 


CheekReservedKey (Replaced) 


CheckReservedKey function return whether TV Viewer reserve this key or not. 


CheckReservedKey( PL_TVMW_KEY key ) 


е key 
Parameter 
о PL TVMW KEY 
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If reserved, returns 1. 
Return Value If not reserved, reutrn O. 
Otherwise, returns error code. 


Remarks 


Emulator 
none 
remarks 


if( 1 == TVMWPlugin.CheckReservedKey(key) ) 
{ 
Ехатріе TVMWPlugin.SendKeyToTV Viewer(key); 


Support from TVMW-0024 
Security Type TVInfo 


4.16.1.2. Deactivate 


Function 
Deactivate (Replaced) 


Deactivate Samsung Smart TV application and activate designated app. (ex: Menu, etc.) 


Deactivate( PL TVMW DTVAPP app) 


PL TVMW DTVAPP 
Parameter 
Application ID to activate after deactivating Samsung Smart TV application 


If success, returns PLR, TRUE. 
Return Value 
Otherwise, returns error code. 
This function is replaced with ActivateApplication function in TaskManager plugin 
Emulator 
none 
remarks 
TVMWPlugin.Deactivate(PL TVMW. DTVAPP NONE); 


Enumeration 
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Support from TVMW-0001 


Security Type TVInfo 


4.16.1.3. GetActiveApp 


Function 


GetActiveApp (Replaced) 


Returns currently active application ID. 


If success, returns active application ID (PL TVMW DTVAPP). 
Return Value 
Otherwise, returns error code. 


This function is replaced with GetActiveApplication function in TaskManager plugin 


Emulator 
[FAKE] returns РІ, TVMW DTV APP INFOLINK [fixed] 
remarks 


var active App, 


var msg, 


аспуеАрр = TVMWPlugin.Get Active App): 
alert(active App): 


alert('active App = ' + active App), 
Ш active App == PL TVMW DTVAPP INFOLINK ) 


{ 


Example 


msg = 'INFOLINK', 


msg = 'Not INFOLINK’; 


document.getElementB yId('ActiveApp").value = msg; 


Enumeration 
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Support from TVMW-0001 


Security Type TVInfo 


4.16.1.4. GetBGApp 


Function 


GetBGApp (Replaced) 


Returns background application of DTV. When the TV no-signal banner, menu, etc. is deactivated, the background 


application will be activated automatically. 


If success, returns the application ID that is registered as background application 
Return Value (РІ, TVMW DTVAPP). 
Otherwise, returns error code. 


This function is replaced with GetBg Application function in TaskManager plugin 
When the TV no-signal banner, menu, etc. is deactivated, the background application will be 
activated automatically. 
ex) 

Remarks 
1) Samsung Smart TV is not set as background. Channel change -> When channel is about to 
change, Samsung Smart TV is deactivated, and channel is changed. 
2) Samsung Smart TV is set as background. Channel change -> When channel is about to change, 
Samsung Smart TV is deactivated, and channel is changed. After hiding channel banner, Samsung 
Smart TV is activated automatically. 


Emulator 


remarks 


var ВСАрр; 
var msg; 
BGApp - TVMWPlugin.GetBGAppO; 
Example alert 'BGApp = ' + BGApp); 
if BGApp == PL TVMW DTVAPP INFOLINK ) 
{ 
msg = INFOLINK'; 
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msg = 'Not INFOLINK’; 
document.getElementByld('BGApp').value = msg; 


Enumeration 


Support from TVMW-0001 
Security Type TVInfo 


4.16.1.5. GetCountry 


Function 


GetCountry (Replaced) 


Return country code of DTV. 


| Parameter | юе 


If success, returns contry сойе(РІ, TVMW COUNTRY). 
Return Value 

Otherwise, returns error code. 

This function is replaced with GetCountry function in TV plugin 


Remarks 


Country code can be changed using DTV menu by user. 


var country = TVMWPlugin.GetCountry(); 


alert('country = ' country); 
Ш country == PL TVMW COUNTRY КОК) 
{ 


Example 
alert('country -- 
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a }TVMWPlugin.GetCountry(); 


Enumeration 


Support from TVMW-0001 
Security Type TVInfo 


4.16.1.6. GetLanguage 


Function 


GetLaneuage (Replaced) 


Return language code of DTV. 


If success, returns language code of DTV (PL_TVMW_LANGUAGE). 
Return Value 

Otherwise, returns error code. 

This function is replaced with GetLanguage function in TV plugin 
Remarks 

Country code can be changed using DTV menu by user. 
Emulator 

none 
remarks 


var language = TVMWPlugin.GetLanguage(); 


alert(‘language = ' + language); 
if( language == PL_TVMW_LANGUAGE_KOR ) 
{ 


Example 


} 
TVMWPlugin.GetLanguage(); 
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е РІ, TVMW LANGUAGE 
Enumeration 


Support from TVMW-0001 
Security Type TVInfo 


4.16.1.7. GetProfile 


Function 


GetProfile 


Returns information stored in flash for predefined profile field of DTV platform. 


GetProfile( PL TVMW PRFID profileID ) 


е  profileID 
o PL TVMW PRFID 
Parameter 

o Profile id to get profile information 

If success, returns value of profile ID 

Return Value 
Otherwise, returns error code. 
Profile on DTV is similar to registry on Windows OS. DTV developer can use a profile field in 
Remarks 
flash to keep small information permanently, and share it with other applications. 


К NN 

Empty body. 

remarks 
TVMWPlugin.SetProfileeIPL. TVMW PRFID TICKER ID, 1234567890123); 
document.getElementB yId( Profile0^.value = 
TVMWPlugin.GetProfile(PL TVMW PRFID TICKER ID); 
document.getElementB yId( Profile1^).value = 
TVMWPlugin.GetProfile(PL TVMW PRFID CHILDLOCK РІМ); 
document.getElementB yld(‘Profile2').value = 


TVMWPlugin.GetProfile(«PL. TVMW PRFID HUB TVID); 


Enumeration 


Support from TVMW-0001 
Security Туре 


Example 


@Samsung Electronics Copyright АП Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


4.16.1.8. GetSource 


Function 


GetSeuree (Replaced) 


Return current source of DTV. (see remarks for source detail) 


If success, returns source of DTV (PL TVMW SOURCE). 
Return Value 
Otherwise, returns error code. 


This function is replaced with GetSource function in TV plugin 

Source means main stream that is displayed on the TV. It can be one of TV, HDMI, 
Remarks COMPONENT, etc. 

To play back multimedia video contents, this source should be set as MEDIA. And to see the TV 

signal, this source should be set as TV. 

(for detail source type, see PL TVMW SOURCE) 


TVMWPlugin.GetSource(): 


Enumeration 


Support from TVMW-0001 
Security Type 


4.16.1.9. GetTVUseMode 


Function 


бе VUseMede (Replaced) 


Returns whether this TV is set for home or for retail shop. 


If success, returns one of PL TVMW TVUT 
Return Value 
Otherwise, returns error code. 
This function is replaced with GetOption(PL SCREEN OPTION SHOP МОРЕ) function in 
Remarks 
Screen plugin 
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Emulator 
none 
remarks 
var TVUseMode; 


var msg; 


TVUseMode = TVMWPlugin.GetT VUseMode(); 


alert(TV UseMode); 
switch( TV UseMode ) 
{ 
case PL_TVMW_TVUT_HOME: 
msg = "Home"; 
break; 
Example case PL TVMW TVUT SHOP: 
msg = "Shop": 
break; 
case PL TVMW TVUT UNKNOWN: 
msg = "Unknown"; 
break; 
default: 


msg = "Error"; 


document.getElementB yId(‘TVUseMode').value = msg; 


LIE ai 
Enumeration 


Support from TVMW-0001 
Security Type TVInfo 


4.16.1.10.  IsRegisteredKey 


Function 


IsRegisteredKey (Replaced) 


Returns whether the key is already registered for the Widget. Widgets should register a key to use it. (see RegisterKey()) 
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If registered, returns PLR TRUE. 
Return Value If not registered, returns PLR FALSE. 
If fail to get information, return error code. 
This function is replaced with IsRegisteredKey function in AppCommon plugin 
Remarks 
Widget should register a key to use the key. (see RegisterKey()) 


Emulator 
Same as TV. 
remarks 


TVMWPlugin.IsRegisteredKey(PL TVMW KEY. 3); 


Enumeration 


Support from TVMW-0001 
Security Type TVInfo 


4.16.1.11.  RegisterKey 


Function 


ResisterKey (Replaced) 


Register key to be used by widgets. 


RegisterKey( PL TVMW KEY key) 


. key 


o PL TVMW KEY 
Parameter 


o Key to use 


If success, returns PLR TRUE. 
Return Value 
Otherwise, returns error code. 


This function is replaced with RegisterKey function in AppCommon plugin 

If the widget has registered the CHANNEL UP key, and CHANNEL UP is pressed on the remote 
Remarks 

controller, then the widget can respond to CHANNEL UP(the widget can map CHANNEL UP to 

a page up operation). But if the widget has not registered CHANNEL, UP, and CHANNEL UP is 

pressed on the remote controller, then the widget cannot respond to it, and the DTV platform will 
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perform a channel up operation (because of this, Samsung Smart TV including the widget is 
automatically deactivated) 


[CAUTION] Key registering affects not just each individual widget, but all widgets on Samsung 


Smart TV, including Samsung Smart TV application itself. 


Emulator 
Same as TV. 
remarks 


Example TVMWPlugin.RegisterKey(PL TVMW KEY 3); 


А е PL TVMW KEY 
Enumeration 


Version Support from TVMW-0001 
Security Type TVInfo 


4.16.1.12.  RegisterKeyGroup 


Function 


ResisterKeyGreup (Replaced) 


Register a group of keys to be used by widgets. This is the same as using Registerkey() several times, once for each key. 


RegisterKeyGroup( PL TVMW KEY GRP keyGroup ) 


е keyGroup 
o PL TVMW KEY GRP 
Parameter 
o  Predefined key group 


If success, returns PLR TRUE. 
Return Value 
Otherwise, returns error code. 


This function is replaced with Register[GroupName Key function in AppCommon plugin 
Remarks 
See remarks of RegisterKey() for key details. 
Emulator 
Same as TV. 
remarks 
TVMWPlugin.RegisterKeyGroup(PL TVMW KEY GRP NUMBER): 


Enumeration 


Support from TVMW-0001 
Security Type | TVInfo 
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4.16.1.13.  SendKeyToTVViewer 


Function 


SendKeyToTV Viewer (Replaced) 


SendKeyToTV Viewer function send key to TV Viewer. 


SendKeyToTV Viewer( PL TVMW KEY key) 


. key 
o PL TVMW KEY 
Parameter 
[9] 


If success, returns 1. 
Return Value . 
Otherwise, returns error code. 


Remarks 


Emulator 
none 
remarks 


if( 1 == TVMWPlugin.CheckReservedKey(key) ) 
{ 
Example TVMWPlugin.SendKeyToTV Viewer(key); 


Support from TVMW-0024 
Security Type TVInfo 


4.16.1.14. SetProfile 


Function 
SetProfile 


Sets the value of a predefined profile field of DTV platform. 


бе Ргое( PL TVMW PRFID profileID, STRING value ) 


e  profileID 
o PL TVMW PRFID 


Parameter 
o Designated field to be set 
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о STRING 


o Value to be set 


If success, returns PLR TRUE. 
Return Value 
Otherwise, returns error code. 


Profile on DTV is similar to registry on Windows OS. DTV developer can use a profile field in 
Remarks 


flash to keep small information permanently, and share it with other applications. 


Emulator 
Empty body. 
remarks 


TVMWPlugin.SetProfileeIPL. TVMW PRFID TICKER ID, '1234567890123'); 


document.getElementB yId( Profile0^).value = 
TVMWPlugin.GetProfile(PL TVMW PRFID TICKER ID); 
document.getElementB yld(‘Profile1').value = 
TVMWPlugin.GetProfile(PL_TVMW_PRFID_CHILDLOCK_PIN); 
document.getElementB yld(‘Profile2').value = 
TVMWPlugin.GetProfile(PL TVMW PRFID HUB TVID); 


Example 


PL TVMW PRFID 


Support from TVMW-0001 


System 


4.16.1.15.  SetSource 


Function 
SetSeuree (Replaced) 


Set new source for ТУ. (see remarks for source detail) 


SetSource( PL TVMW SOURCE source ) 


e source 
о РІ, TVMW SOURCE 
Parameter 
o Source to be set 


If success, returns PLR TRUE. 
Return Value 
ҢҢ returns error code. 


| Remarks | This function is | This function is replaced with SetSource function in TV plugin... | with SetSource function in TV plugin 
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Source means main stream that is displayed on the TV. It can be one of TV, HDMI, 


COMPONENT, etc. 
To play back multimedia video contents, this source should be set as MEDIA. And to see the TV 
signal, this source should be set as TV. (When a widget sets the source as MEDIA, the DTV video 
layer displays a black screen) 
(for detail source type, see PL TVMW SOURCE) 

Emulator [FAKE] When a widget sets the source as MEDIA, the DTV video layer displays a black screen. If 


remarks any other source is set, no action is taken, the value is kept in memory only. 


Example TVMWPlugin.SetSource(PL TVMW SOURCE TV); 


Enumeration 


Support from TVMW-0001 
Security Туре 


4.16.1.16.  SetWatchDog 


Function 


SetWatehDes (Replaced) 


Register or unregister a widget to watchdog queue (see remarks for watchdog detail) 


SetWatchDog( PL TVMW WATCHDOG watchDog ) 


e ас ос 
о PL TVMW WATCHDOG 
o  watchDog On/Off 


Parameter 


If success, returns PLR, TRUE. 
Return Value 
Otherwise, returns error code. 


This function is replaced with SetWatchDog function in TV plugin 

When Watchdog is enabled, if a thread is busy for too much time (more than about 30 seconds), 

then the DTV platform checks this state and reboots the DTV automatically to avoid blocking 
"Hn forever. All threads including widgets are already set as Watchdog on. But sometimes, a widget 

needs to be busy for more than about 30 seconds to process its own functionality, in this case that 

widget has to set Watchdog off during this processing. After finishing this long processing, the 

widget has to set the watchdog state back to ON. 
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(НЕЕ [WARNING] А widget that does not follow this rule cannot released officially. 


Emulator 
[FAKE] Do nothing, just print out function name on debug console in SDK. 


remarks 


TVMWPlugin.SetWatchDog(PL TVMW WATCHDOG OFF): 


Kaw] An ИННА PL TVMW WATCHDOG 
Enumeration 


| Version | | Support from TYMW-0001 O from TVMW-0001 


Security Туре | TVInfo 


4.16.1.17. UnregForBGApp 


Function 


UnregForBGApp (Replaced) 


Unregister a designated application from background application list. 


UnregForBGApp( PL TVMW DTVAPP app) 


PL TVMW DTVAPP 

o Application ID to be unregistered as background application. If this parameter 
Parameter 

is emply, then PL TVMW DTV APP INFOLINK (Samsung Smart TV 

Application ID) is used as a default. 


If success, returns PLR, TRUE. 
Return Value 

Otherwise, returns error code. 
This function is replaced with SetBgApplication function in TaskManager plugin 

Remarks 
See remarks of GetBGApp for background application details. 

Emulator 
none 

remarks 

TVMWPlugin.UnregForBGApp(); 


Enumeration 


Support from TVMW-0001 
Security Type 
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4.16.1.18.  UnregisterKey 


Function 


UnresisterKey (Replaced) 


Unregister the key so it is not used by widgets. 


UnregisterKey( PL TVMW KEY key ) 


PL TVMW KEY 
Parameter 
Key to be unregistered 


If success, returns PLR TRUE. 
Return Value 
Otherwise, returns error code. 


This function is replaced with UnregisterKey function in AppCommon plugin 
Remarks 
See remarks in RegisterKey for Key Registration details. 
Emulator 
Same as TV. 
remarks 
TVMWPlugin.UnregisterKey(PL TVMW KEY. 3); 


Enumeration 


Support from TVMW-0001 
Security Type TVInfo 


4.16.1.19.  UnregisterKeyGroup 


Function 


UnregisterKeyGroup (Replaced) 


Unregister a group of keys so they are not used by widgets. 


UnregisterKeyGroup( PL TVMW KEY GRP keyGroup ) 


е keyGroup 
o PL TVMW KEY GRP 


Parameter 
o Key group to be unregistered 


Return Value If success, returns PLR TRUE. 
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ct Otherwise, returns error code. 


This function is replaced with Unregister[ GroupName]Key function in AppCommon plugin 


Remarks 


See remarks in RegisterKey for Key Registration details. 


Emulator 
Same as TV. 
remarks 


TVMWPlugin.UnregisterKeyGroup(PL TVMW KEY. GRP NUMBER); 


е РІ, TVMW KEY GRP 
Enumeration 


Support from TVMW-0001 
Security Type | TVInfo 


4.16.2. Enumeration 


4.16.2.1. PL TVMW COUNTRY 


Enumeration 
PE. ТУМА COUNTRY (Replaced) 


Country 


This enum is replaced with РІ, TV COUNTRY enum in TV plugin 


Emulator 
none 
remarks 


е GetCeuntry (Replaced) 
Function 


PL TVMW COUNTRY USA 
o USA 
PL TVMW COUNTRY KOR 
o Korea 


PL TVMW COUNTRY SPA 


o Spain 


PL TVMW COUNTRY FRA 


o France 
PL TVMW COUNTRY JPN 
o Japan 


PL TVMW COUNTRY EU 
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o Europe 

PL TVMW COUNTRY UK 

o United kingdom 

PL TVMW COUNTRY GERMANY 
o Germany 
PL TVMW COUNTRY. ITALY 
o Italy 
PL TVMW COUNTRY SWEDEN 


о Sweden 

10 - РІ, TVMW COUNTRY BULGARIA 
o Bulgaria 
- PL TVMW COUNTRY CROATIA 
o Croatia 

12 - РІ, TVMW COUNTRY CZECH 
o Czech 

13 - РІ, TVMW COUNTRY NETHERLANDS 
o Netherlands 

14 - PL TVMW COUNTRY GREECE 
o Greece 
- PL TVMW COUNTRY HUNGARY 
o Hungary 

16 - PL TVMW COUNTRY POLAND 
o Poland 

17 - PL TVMW COUNTRY PORTUGAL 


o Portugal 


18 - PL TVMW COUNTRY ROMANIA 


o Romania 
19 - PL TVMW COUNTRY RUSSIA 
o Russia 
20 - PL TVMW COUNTRY. SWITZERLAND 
o Switzerland 
21 - РІ, TVMW COUNTRY TURKEY 
o Turkey 
22 - PL TVMW COUNTRY AUSTRALIA 
o Australia 


23 - РІ. TVMW COUNTRY. AUSTRIA 
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o Austria 

- PL TVMW COUNTRY BELGIUM 

o Belgium 

- PL TVMW COUNTRY DENMARK 
o Denmark 

- PL TVMW COUNTRY FINLAND 

o Finland 

- PL TVMW COUNTRY NORWAY 

o Norway 

- PL TVMW COUNTRY CHINA 

o China 

- PL TVMW COUNTRY IRELAND 

o Ireland 

- PL TVMW COUNTRY SERBIA 

o Serbia 

- PL TVMW COUNTRY SAN MARINO 
о бап Marino 

- PL TVMW COUNTRY МОМАСО 

o Monaco 

- PL TVMW COUNTRY BRAZIL 

o Brazil 

- PL TVMW COUNTRY HONGKONG 
o Hongkong 

- PL TVMW COUNTRY TAIWAN 

o Taiwan 

- PL TVMW COUNTRY NEWZEALAND 
o  Newzealand 

- PL TVMW COUNTRY SLOVAKIA 
o Slovakia 


- PL TVMW COUNTRY SINGAPORE 


o Singapore 


- PL TVMW COUNTRY GENERALCABLE 


o Generalcable 
- PL TVMW COUNTRY OTHER 
o Others 


- PL TVMW COUNTRY ASIAWEUROPE ANALOG 
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о Asia west europe (analog) 

42 - PL TVMW COUNTRY HONGKONG UK ANALOG 
o Hongkong UK (analog) 

43 - РІ. TVMW COUNTRY NZL INDONESIA ANALOG 
о  Newzealand Indonesia (alalog) 


44 - PL TVMW COUNTRY SOUTH AFRICA ANALOG 


o South africa (analog) 


45 - PL TVMW COUNTRY AMERICA ANALOG 
o America (analog) 
46 - PL TVMW COUNTRY CHINA ANALOG 
o China (analog) 
47 - PL TVMW COUNTRY EASTEUROPE ANALOG 


о East europe (analog) 


4.16.2.2. PL TVMW DTVAPP 


Enumeration 
РЕ-ТУМУ/ РТУАРР (Replaced) 
DTV Application 


This enum is replaced with РГ. TASKMANAGER DTVAPP enum in TaskManager plugin 


Emulator 


remarks 


Deaetivate (Replaced) 
GetActiveApp (Replaced) 
Repl 
Function GetBGApp (Replaced) 
RegForBGApp (Replaced) 
UnrecForBGApp (Replaced) 
0 - РІ, TVMW DTVAPP NONE 
o default app 
1 - РІ, TVMW DTVAPP TVVIEWER 
Value 
o TVViewer 
2 - PL TVMW DTV, APP INFOLINK 
o Infolink 
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е 3-РІ, TVMW DTVAPP MENU 


o Menu 


4.16.2.3. РІ, TVMW KEY 


Enumeration 
PE. FVMW KEY (Replaced) 


Key 


This enum is replaced with [Un]RegisterKey functions in AppCommon plugin 
Emulator 
remarks 

IsResisteredKey (Replaced) 

ResisterKey (Replaced) 

UnresisterKey (Replaced) 


Function 


PL TVMW KEY I 
o Number 1 
PL TVMW KEY 2 


o Number 2 


PL TVMW KEY 3 


o Number 3 
PL TVMW KEY 4 
о Number 4 
PL TVMW KEY 5 
o Number 5 
PL TVMW KEY 6 
o Number 6 
PL TVMW KEY 7 
o Number 7 
PL TVMW KEY 8 
o Number 8 


PL TVMW KEY 9 


o Number 9 


PL TVMW KEY 0 
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o Number 0 
10 - PL TVMW KEY HYPHEN 
o Нурһеп(-) 
11 - PL TVMW KEY 1 
o Number 11 
101 - PL TVMW KEY CH UP 
Channel up 
PL TVMW KEY CH DOWN 
Channel down 
PL TVMW KEY CH PREV 
Previous channel 
PL TVMW KEY CH FAV 
Favorite channel 
PL TVMW KEY CH LIST 
Channel list 
PL TVMW KEY CH PANNEL UP 
Pannel channel up 
PL TVMW KEY CH PANNEL DOWN 
Pannel channel down 


PL TVMW KEY VOL UP 


Volume up 


PL TVMW KEY VOL DOWN 


Volume down 
PL TVMW KEY MUTE 
Mute 
PL TVMW KEY VOL PANNEL UP 
Pannel volume up 
PL TVMW KEY VOL PANNEL DOWN 
Pannel volume down 
PL TVMW KEY ENTER 
Enter 
PL TVMW KEY RETURN 
Return 
PL TVMW KEY EXIT 
Exit 
PL TVMW KEY ARROW UP 
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Arrow up 

PL TVMW KEY ARROW DOWN 
Arrow down 

РІ, TVMW KEY ARROW LEFT 
Arrow left 

PL TVMW KEY ARROW RIGHT 
Arrow right 

PL TVMW KEY WHEEL LEFT 
Wheel left 

PL TVMW KEY WHEEL RIGHT 
Wheel right 

PL TVMW KEY PANNEL ENTER 
Pannel enter 

PL TVMW KEY RED 
Color key red 

PL TVMW KEY GREEN 
Color key green 

PL TVMW KEY YELLOW 
Color key yellow 

PL TVMW KEY CYAN 


Color key cyan 
PL TVMW KEY REWARD 


Color key reward 

PL TVMW KEY PAUSE 
Playback key pause 

PL TVMW KEY FOWARD 
Playback key foward 

PL TVMW KEY PLAY 
Playback key play 

PL TVMW KEY STOP 
Playback key stop 

PL TVMW KEY REC 
Playback key rec 

PL TVMW KEY INFO 
Info 

PL TVMW KEY TOOLS 
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Tools 

PL TVMW KEY. INFOLINK 
Infolink (Info.L) 

PL TVMW KEY EMODE 
Entertainment mode 

PL TVMW KEY DATA 
Data 

PL TVMW KEY DMA 
DMA 

PL TVMW KEY CONTENTS 
Contents 

PL TVMW KEY MENU 
Menu 

PL TVMW KEY WISELINK 
Wiselink (W.Link) 

PL TVMW KEY SOURCE 
Source 

PL TVMW KEY POWER 
Power 

PL TVMW KEY TV 
TV 

PL TVMW KEY PANNEL SOURCE 
Pannel source 

PL TVMW KEY PANNEL MENU 
Pannel menu 

PL TVMW KEY PANNEL POWER 
Pannel power 

PL TVMW KEY TTX MIX 
TTX MIX 

PL TVMW KEY GUIDE 
Key guide 

PL TVMW KEY SUBTITLE 
Subtitle 


PL TVMW KEY ASPECT 


Aspect 
PL TVMW KEY DOLBY SRR 
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o Dolby surround 
655 - PL TVMW KEY MTS 
o MTS 
656 - PL TVMW KEY REPEAT 


o Repeat 


1023 - PL TVMW KEY STEP 
o STEP 

1032 - PL TVMW KEY PIP ONOFF 
o РІР ONOFF 

1039 - PL TVMW KEY AD 
o AD 

1040 - PL TVMW KEY PMODE 
о PMODE 

1043 - РІ, TVMW KEY SMODE 
о SMODE 

1050 - РІ, ТУМУУ КЕҮ РІР СНОР 
о РІР СНОР 

1051 - РІ, TVMW KEY РІР CHDOWN 
о РР CHDOWN 

1078 - PL TVMW KEY FF. 
o FF 

1080 - РІ, TVMW KEY REWIND. 
о REWIND 

1086 - РІ, TVMW KEY DISC MENU 
о DISC MENU 

1089 - РІ, TVMW KEY SUB TITLE 
o SUB TITLE 

1097 - PL TVMW KEY SLEEP 
o SLEEP 

1105 - РІ, TVMW KEY PCMODE 
о РСМОПЕ 

1132 - PL TVMW KEY AVI 
o AVI 

1133 - PL TVMW KEY SVIDEOI 
о SVIDEOI 

1134 - РІ, TVMW KEY COMPONENTI 
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COMPONENTI 

PL TVMW KEY COMPONENT2 
COMPONENT2 

PL TVMW KEY HDMI 
HDMI 

PL TVMW KEY AV2 
AV2 

PL TVMW KEY AV3 
AV3 

PL TVMW KEY SVIDEO2 
SVIDEO2 

PL TVMW KEY SVIDEO3 
SVIDEO3 

РІ, TVMW KEY 7ООМ2 
Z00M2 

PL TVMW KEY PANORAMA 
PANORAMA 

PL TVMW KEY 4 3 
4 3 

PL TVMW KEY 16 9 
16 9 

PL TVMW KEY DYNAMIC 
DYNAMIC 

PL TVMW KEY STANDARD 
STANDARD 

РІ, TVMW KEY МОУІЕІ 
MOVIEI 

PL TVMW KEY CUSTOM 
CUSTOM 

PL TVMW KEY HDMII 
HDMII 

РІ, TVMW KEY HDMI2 
HDMI2 

PL TVMW KEY HDMI3 
HDMI3 

PL TVMW KEY HDMI4 
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HDMI4 
PL_TVMW_KEY_AV2 
AV2 
PL_TVMW_KEY_AV3 
AV3 
PL_TVMW_KEY_SVIDEO2 
SVIDEO2 
PL_TVMW_KEY_SVIDEO3 
SVIDEO3 
PL_TVMW_KEY_ZOOM2 
ZOOM2 
PL_TVMW_KEY_PANORAMA 
PANORAMA 
PL TVMW KEY 4 3 
4 3 
PL TVMW KEY 16 9 
16 9 
1173 - PL TVMW KEY DYNAMIC 
о DYNAMIC 
1174 - PL TVMW KEY STANDARD 
о STANDARD 
1175 - PL TVMW KEY MOVIEI 
о МОУ 
1176 - РІ, TVMW KEY CUSTOM 
о CUSTOM 
1119 - РІ. TVMW KEY ESAVING 
о  ESAVING 
1128 - PL TVMW KEY CALLER ID 
o CALLER ID 
1217 - PL TVMW KEY TILT 
o TILT 
1218 - PL TVMW KEY EZ VIEW 
o EZ VIEW 
1219 - PL TVMW KEY 3D 
o 3D 
1220 - PL TVMW KEY AUTO ARC PVR RECORDING TEST 
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о AUTO ARC РУК RECORDING TEST 
1221 - РІ, TVMW KEY AUTO ARC PVR PLAY TEST 
о AUTO ARC РУК PLAY TEST 
1222 - PL TVMW KEY AUTO ARC PVR DELETE ALL 
o “AUTO ARC РУК DELETE ALL 
1223 - PL TVMW KEY AUTO ARC HOTEL INTERACTIVE 
o AUTO ARC HOTEL INTERACTIVE 
1224 - PL TVMW KEY D LIST UP 
o D LIST UP 
1225 - PL TVMW KEY D LIST DOWN 
o D LIST DOWN 
1226 - PL TVMW KEY D ONDEMAND 
o D ONDEMAND 
1227 - PL TVMW KEY D PANNEL VIRTUAL ENTER 
o D PANNEL VIRTUAL ENTER 
1228 - PL TVMW KEY D PANNEL VIRTUAL SOURCE 
o D PANNEL VIRTUAL SOURCE 
1229 - PL TVMW KEY D REC PAUSE 
o D REC PAUSE 
1230 - PL TVMW KEY D CONTINUED FF 
o D CONTINUED FF 
1231 - PL TVMW KEY D CONTINUED RW 
o D CONTINUED RW 
1232 - PL TVMW KEY D CONTINUED OFF 
o D CONTINUED OFF 
1233 - PL TVMW KEY D CANCEL 
o D CANCEL 
1234 - PL TVMW KEY D TITLE MENU 
o D TITLE MENU 
1235 - PL TVMW KEY D REPEAT AB 
o D REPEAT AB 
1236 - PL TVMW KEY D AUDIO 
o р AUDIO 
1237 - PL TVMW KEY D REC MODE 
o D REC MODE 
1238 - PL TVMW KEY D USB 
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D USB 

PL TVMW KEY D HDD 
D HDD 

PL TVMW KEY D DISC 
D DISC 

PL TVMW KEY D TEST 
D TEST 

PL TVMW KEY D COPY 
D COPY 

PL TVMW KEY D FRONT PLAY 
D FRONT PLAY 

PL TVMW KEY D FRONT STOP 
D FRONT STOP 

PL TVMW KEY D FRONT FF 
D FRONT FF 

PL TVMW KEY D FRONT RW 
D FRONT RW 

PL TVMW KEY D FRONT REC 
D FRONT REC 

PL TVMW KEY D VERSION DISPLAY KEU 
D VERSION DISPLAY KEU 

PL TVMW KEY D VIEW MODE 
D VIEW MODE 

PL TVMW KEY D COLD START 
D COLD START 


4.16.2.4. РІ, TVMW KEY СЕР 


Enumeration 


PE. FVMW KEY GRP (Replaced) 


Key group 


This enum is replaced with [Un]Register[ GroupName]Key functions in AppCommon plugin 
Emulator 
none 
remarks 
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RegisterKeyGroup (Replaced) 
Function UnregisterKeyGroup (Replaced) 


PL TVMW KEY GRP ALL 
o АП keys 
PL_TVMW_KEY_GRP_NUMBER 
о АП number keys 
PL_TVMW_KEY_GRP_CHANNEL 
о АП channel keys 
PL_TVMW_KEY_GRP_VOLUME 
Value о АП volume keys 
PL_TVMW_KEY_GRP_NAVI 
о АП nnavi keys 
PL_TVMW_KEY_GRP_COLOR 
o АП color keys 
PL_TVMW_KEY_GRP_PLAYBACK 
o All playback keys 


4.16.2.5. PL_TVMW_LANGUAGE 


Enumeration 
PE. FVMW LANGUAGE (Replaced) 


Language 


This enum is replaced with PL TV LANGUAGE enum in TV plugin 


Emulator 
none 
remarks 


Function 


е 0 - PL TVMW LANGUAGE КОК 
о КОК 

е 1- PL TVMW LANGUAGE ENG US 
о ENG US 

е 2-РІ, TVMW LANGUAGE SPA US 
o SPA US 
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PL TVMW LANGUAGE FRA US 
o FRA US 
PL TVMW LANGUAGE POR US 
о РОК US 
PL TVMW LANGUAGE BUL 
o BUL 
PL TVMW LANGUAGE CRO 
o CRO 
PL TVMW LANGUAGE CZE 
o CZE 
PL TVMW LANGUAGE DAN 
o DAN 
PL TVMW LANGUAGE DUT 
o DUT 

10 - PL TVMW LANGUAGE FIN 
o FIN 
- PL TVMW LANGUAGE FRA 
o FRA 
- PL TVMW LANGUAGE DEU 
o DEU 
- PL TVMW LANGUAGE GRE 
o GRE 
- PL TVMW LANGUAGE HUN 
o HUN 
- PL TVMW LANGUAGE ITA 
o ITA 
- PL TVMW LANGUAGE NOR 
o NOR 
- PL TVMW LANGUAGE ENG 
o ENG 
- PL TVMW LANGUAGE POL 
o POL 
- PL TVMW LANGUAGE POR 
o POR 
- PL TVMW LANGUAGE ROM 
o КОМ 
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- PL TVMW LANGUAGE RUS 
o RUS 
- PL TVMW LANGUAGE, SER 
o SER 
- PL TVMW LANGUAGE SLK 
o SLK 
- PL TVMW LANGUAGE SPA 
o SPA 
- PL TVMW LANGUAGE SWE 
o SWE 
- PL TVMW LANGUAGE TUR 
o TUR 
- PL TVMW LANGUAGE CHI 
o CHI 
- PL TVMW LANGUAGE HKG 
о HKG 
- PL TVMW LANGUAGE TPE 
o TPE 
- PL TVMW LANGUAGE JPN 
o JPN 
- PL TVMW LANGUAGE MAO 
о МАО 
- PL TVMW LANGUAGE СММ 
o СММ 
- PL TVMW LANGUAGE YUE 
o YEU 
- PL TVMW LANGUAGE HIN 
o HIN 
- PL TVMW LANGUAGE EST 
o EST 
- PL TVMW LANGUAGE LAT 
o LAT 
- PL TVMW LANGUAGE LTU 
o LTU 
- PL TVMW LANGUAGE ARA 
o ARA 
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39 - PL TVMW LANGUAGE PER 
o PER 
40 - PL TVMW LANGUAGE QAA 
o QAA 
41 - PL TVMW LANGUAGE AD 
o AD 
42 - PL TVMW LANGUAGE САТ 
o CAT 
43 - PL TVMW LANGUAGE VAL 
o VAL 
44 - PL TVMW LANGUAGE HEB 
o HEB 
45 - PL TVMW LANGUAGE OTHER 
o OTHER 
46 - PL TVMW LANGUAGE THA 
o THA 


4.16.2.6. PL TVMW PRFID 


Enumeration 
PL TVMW PRFID 
Profile ID 


Emulator 


remarks 


GetProfile 
Function SetProfile 


0 - PL TVMW PRFID TICKER ID 
o Ticker ID 
1- PL TVMW PRFID CHILDLOCK PIN 
Value 
o  Childlock PIN number 
2 - PL TVMW PRFID НОВ ТУШ 
o HubTVID 
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PL TVMW PRFID TICKER AUTOBOOT 
o ТісКег autoboot 
PL TVMW PRFID TICKER DURATION 
o ТісКег duration 


PL TVMW PRFID WIDGET DPTIME 


o Widget display time 


PL TVMW PRFID CONTRACT 
o Contract 
PL TVMW PRFID TICKER SAFE 
o Ticker safe 
PL TVMW PRFID RESET 
o Reset 
PL TVMW PRFID PASSWD RESET 
o Password reset 
10 - PL TVMW PRFID GEOIP STATUS 
o  GeolP status 
11 - PL TVMW PRFID COUNTRY CODE 
o Country code 
12 - PL TVMW PRFID WLAN DEFAULT NETWORK 
o  wired(0) or wiress(-1) 
13 - PL TVMW PRFID AUTO PROTECTION TIME 
o Auto protection time 


14 - PL TVMW PRFID CHANNEL BOUND EXECUTE 


o Channel bound execute 


4.16.2.7. PL TVMW SOURCE 


Enumeration 


PL-TVMW-SOURCE (Replaced) 


none 


This enum is replaced with РІ. WINDOW SOURCE enum in TV plugin 


Emulator 


remarks 
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ШЕН е  SetSeuree (Replaced) 


PL TVMW SOURCE TV 

o TV 

PL TVMW SOURCE ATV 

о АТУ 

РГ. TVMW SOURCE DTV 

о DTV 

РІ, TVMW SOURCE САТУ 

о САТУ 

PL TVMW SOURCE CDTV 

o CDTV 

PL TVMW SOURCE PATV 

о РАТУ 

PL TVMW SOURCE PDTV 

о РОТУ 

PL TVMW SOURCE SDTV 

о SDTV 

PL TVMW SOURCE BSDTV 

о BSDTV 

PL TVMW SOURCE CSIDTV 

о CSIDTV 
10 - PL TVMW SOURCE CS2DTV 

o CS2DTV 
11 - PL TVMW SOURCE ATVI 

o ATVI 
12 - PL TVMW SOURCE ATV2 

о АТУ2 
13 - PL TVMW SOURCE DTVI 

о ТУІ 
14 - РІ. TVMW SOURCE DTV2 

о DTV2 
15 - PL TVMW SOURCE AVI 

o AVI 
16 - PL TVMW SOURCE AV2 

о AV2 
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- PL TVMW SOURCE AV3 
o АУЗ 
- PL TVMW SOURCE AVA 
o АУ4 
- PL TVMW SOURCE SVIDEOI 
o SVIDEO1 

- PL TVMW SOURCE SVIDEO2 
о SVIDEO2 

- PL TVMW SOURCE SVIDEO3 
o SVIDEO3 

- PL TVMW SOURCE SVIDEOA 
о SVIDEO4 

- PL TVMW SOURCE COMPI 
o СОМРІ 

- PL TVMW SOURCE COMP2 
o СОМР2 

- PL TVMW SOURCE COMP3 
o  COMP3 

- PL TVMW SOURCE COMPA 
o СОМР4 

- PL TVMW SOURCE PCI 

o PCI 
- PL TVMW SOURCE PC2 
o PC2 
- PL TVMW SOURCE PC3 
о РСЗ 
- PL TVMW SOURCE PC4 
o PC4 
- PL TVMW SOURCE HDMII 
o HDMII 

- PL TVMW SOURCE HDMD 
o HDMI2 

- PL TVMW SOURCE HDMI3 
о HDMI 

- PL TVMW SOURCE HDMIA 
o HDMI4 
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- PL TVMW SOURCE 5САКТІ 
о 5САКТІ 
- PL TVMW SOURCE SCART2 
о SCART2 
- PL TVMW SOURCE SCART3 
о  SCART3 
- PL TVMW SOURCE SCART4 
о SCART4 
- PL TVMW SOURCE DVII 
о РУП 
- PL TVMW SOURCE DVD 
о DVD 
- PL TVMW SOURCE DVI3 
o DVB 
- PL TVMW SOURCE DVI4 
o DVIA4 
- PL TVMW SOURCE MEDIA 
о MEDIA 
- PL TVMW SOURCE HOMING 
о DCRHOMING 
- PL TVMW SOURCE NONE 


o No source 


4.16.2.8. PL TVMW TVUT 


Enumeration 
PE. FVMW TVUT (Replaced) 


TV use type 


This enum is replaced with GetOption(PL SCREEN, OPTION SHOP МОРЕ) function in Screen 


Remarks 


plugin 


Emulator 


remarks 


GetTVUseMede (Кері 
| | u С 
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e 0 - PL TVMW TVUT HOME 


o Home 
e 1 - РГ TVMW TVUT SHOP 
o Shop 


4.16.2.9. PL TVMW WATCHDOG 


Enumeration 
PL-TVMW-WATCHDOG (Replaced) 


Watchdog 


This enum is replaced with SetWatchDog function in TV plugin 


Emulator 
none 
remarks 


: SetWatehDog (Кері 


e 0 - PL TVMW WATCHDOG ON 
o Watchdog On 

e 1- PL TVMW WATCHDOG OFF 
o Watchdog Off 


4.17. TaskManager 
4.17.1. Function 
4.17.1.1. ActivateApplication 


Function 


ActivateApplication 


ActivateApplication function activate new application ( ex : PL TASKMANAGER DTVAPP INFOLINK2 or etc... ) 


ActivateApplication( PL TASKMANAGER DTVAPP Application ) 


@Samsung Electronics Copyright АП Rights Reserved 


ОемсеАР! Guide for Samsung Smart TV 


е Application 


о РІ, TASKMANAGER DTVAPP 
Parameter 


o Application to be actiavted 


Return If success, returns positive value. 


Value otherwise, returns negative value 


Remarks 


Emulator 
Only returns true 
remarks 


TaskManagerPlugin.ActivateA pplication(PL_TASKMANAGER_DTVAPP_INFOLI 
NK2); 


Example 


Enumeratio е PL TASKMANAGER DTVAPP 


Version Support from TASKMANAGER-0001 
Security 


Type 


System 


4.17.1.2. GetActiveApplication 


Function 
Get Active Application 


GetActive Application function returns a current activated application ( ex : GetActiveApplication etc... ) 


GetActiveApplication( ) 


If success, a current activated application (PL TASKMANAGER, DTVAPP), 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator 


Only returns true 
remarks 


if( PL TASKMANAGER DTVAPP INFOLINK2 == 
TaskManagerPlugin.GetActiveA pplication()) 


Example 
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e РІ. TASKMANAGER DTVAPP 
Enumeration 


Support from TASKMANAGER-0001 
Security Type TVInfo 


4.17.1.3. GetBgApplication 


Function 


Се Ве Application 
GetBgApplication function returns a background application ( ех: PL TASKMANAGER DTVAPP INFOLINK2 ог 


etc... ) 


If success, a background application (PL TASKMANAGER DTVAPP), 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator 
Only returns false 
remarks 


if( PL TASKMANAGER DTVAPP INFOLINK2 == 


TaskManagerPlugin.GetB gApplication()) 


Example 
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e PL TASKMANAGER DTVAPP 
Enumeration 


Support from TASKMANAGER-0001 
Security Type TVInfo 


4.17.1.4. SetBg Application 


Function 


бе Ве Application 
SetBgApplication function sets a background application ( ex : PL TASKMANAGER DTVAPP INFOLINK2 or 


etc... ) 
SetBgApplication( PL TASKMANAGER DTVAPP Application ) 


e Application 
о РІ, TASKMANAGER DTVAPP 


Parameter 
o Application to be registered as background application 


Return If success, returns positive value. 
Value otherwise, returns negative value 


Remarks 


Emulator 
Only returns false 
remarks 


TaskManagerPlugin.SetBgApplication(PL TASKMANAGER DTVAPP INFOLIN 
K2); 


Enumeratio е PL TASKMANAGER, DTVAPP 


n 
Support from TASKMANAGER-0001 
Security 
System 
Type 


4.17.2. Enumeration 


Example 


4.17.2.1. PL TASKMANAGER DTVAPP 


Enumeration 


PL TASKMANAGER DTVAPP 
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Application ( ex : Infolink, Wiselink, ... ) 


Remarks 


Emulator 


remarks 


GetActiveApplication 

GetBgApplication 
Function SetBgApplication 

ActivateApplication 


PL TASKMANAGER DTV APP NONE 
PL TASKMANAGER DTV APP TASKMANAGER 
PL TASKMANAGER DTV APP TVVIEWER 
PL TASKMANAGER DTV APP MENU 
PL TASKMANAGER DTV APP EPG 
PL TASKMANAGER DTV APP CM 
PL TASKMANAGER DTV APP CC 
PL TASKMANAGER DTV APP FAC 
PL TASKMANAGER DTV APP CHANNELSEARCH 
PL TASKMANAGER DTV APP ADDDEL 
PL TASKMANAGER DTV APP REMINDER 
PL TASKMANAGER DTV APP SOURCE 
PL TASKMANAGER DTV APP TVTOOLS 
PL TASKMANAGER DTV APP INTERTEST 
PL TASKMANAGER DTV APP INTERNALTEST 
PL TASKMANAGER DTV APP HOTEL 
PL TASKMANAGER DTV APP MINIFAVCH 
PL TASKMANAGER DTV APP EAS 
PL TASKMANAGER DTV APP DV 
PL TASKMANAGER DTV APP HTML 
PL TASKMANAGER DTV APP APPLIST 
PL TASKMANAGER DTV APP JAVAMW 
PL TASKMANAGER DTV APP COMDOWNLOAD 
PL TASKMANAGER DTV APP TTX 
PL TASKMANAGER DTV APP SBT 
PL TASKMANAGER DTV APP CI 


5 ® мз HD Ui ы ы N = = 
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PL TASKMANAGER DTV APP MHEG 

PL TASKMANAGER DTV APP RETURN CHANNEL 
PL TASKMANAGER DTV, APP CU 

PL TASKMANAGER DTV APP FAVCHLIST 

PL TASKMANAGER DTV APP LOGOMANAGER 
PL TASKMANAGER DTV APP GEMSTAR 

PL TASKMANAGER DTV APP FMRADIO 

PL TASKMANAGER DTV APP HOME MENU 

PL TASKMANAGER DTV APP MOVIE WISELINK 
PL TASKMANAGER DTV APP MMBROSWER 

PL TASKMANAGER DTV APP MMPLAYER 

PL TASKMANAGER DTV APP MOVIE PLAYER 
PL TASKMANAGER DTV APP MINT 

PL TASKMANAGER DTV APP WPRO 

PL TASKMANAGER DTV APP DLNA 

PL TASKMANAGER DTV APP DLNACENTER 

PL TASKMANAGER DTV APP DMR 

PL TASKMANAGER DTV APP PMR 

PL TASKMANAGER DTV APP RUIS 

PL TASKMANAGER DTV APP RUIC 

PL TASKMANAGER DTV APP USBLIST 

PL TASKMANAGER DTV APP STORY 

PL TASKMANAGER DTV APP PVR 

PL TASKMANAGER DTV APP PVR EDIT 

PL TASKMANAGER DTV APP PVR BROWSER 
PL TASKMANAGER DTV APP CEC 

PL TASKMANAGER DTV APP CEC DEVICE 

PL TASKMANAGER DTV APP BLUETOOTH 

PL TASKMANAGER DTV APP SWUPGRADE 

PL TASKMANAGER DTV APP OTA 

PL TASKMANAGER DTV APP SWUPGRADE AIR 
PL TASKMANAGER DTV APP OAD 

PL TASKMANAGER DTV APP OAD SAT 

PL TASKMANAGER DTV APP OTN 

PL TASKMANAGER DTV APP SWUCOMMON 

PL TASKMANAGER DTV APP USB HOTEL LOGOCLONE 
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PL TASKMANAGER DTV APP CHMAP TRANSFER 
PL TASKMANAGER DTV APP RSS 

PL TASKMANAGER DTV, APP INFOLINK2 

PL TASKMANAGER DTV APP MEDIALINK 

PL TASKMANAGER DTV APP CONTENTSHOME 
PL TASKMANAGER DTV APP GPLAYER 

PL TASKMANAGER DTV, APP FLASHPLAYER 

PL TASKMANAGER DTV APP TLIBBROWSER 

PL TASKMANAGER DTV APP PRODUCTGUIDE 
PL TASKMANAGER DTV APP USERMANUAL 

PL TASKMANAGER DTV APP GALLERYPLAYER 
PL TASKMANAGER DTV APP CLMOVIEPLAYER 
PL TASKMANAGER ЮТУ APP CLPOP 

PL TASKMANAGER DTV APP WLAN 

PL TASKMANAGER DTV APP YAHOO 

PL TASKMANAGER DTV APP SHOPDEMO 

PL TASKMANAGER DTV APP MAINTVUPNPSERVER 
PL TASKMANAGER DTV APP DUALTV READY 
PL TASKMANAGER DTV APP MOIP 

PL TASKMANAGER DTV APP DNET 

PL TASKMANAGER DTV APP POP 

PL TASKMANAGER DTV APP FRONTRUNNER 
PL TASKMANAGER DTV APP HOTEL IPTV 

PL TASKMANAGER DTV APP IPTV BROWSER 
PL TASKMANAGER DTV APP PHAROS AGENT 
PL TASKMANAGER DTV APP FRONT DISPLAY 
PL TASKMANAGER DTV APP BDP TOOLS 

PL TASKMANAGER DTV APP BDHTS 
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4.18.Time 
4.18.1. Function 


4.18.1.1. ConvertEpochToLocalTime 


Function 


ConvertEpochToLocalTime 


ConvertEpochToLocalTime function returns convert epoch time(UTC) to local time and return it as string 
type(yyyy/mm/dd/hh/mm/ss) 


ConvertEpochToLocalTime( Number epochTime ) 


e  epochTime 
o Number 
Parameter 
o epoch time(UTC) 


If success, local time(yyyy/mm/dd/hh/mm/ss), 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator 
none 
remarks 


var epochTime = TimePlugin.GetEpochTime(); 
TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize = TVPlugin.GetProgramList Size(); 
Ш programListSize > 5 ) 
{ 
programListSize = 5; 
Ехатріе 
for(var 10 ; i<programListSize ; ++i) 
{ 
document.getElementB yId( Те" + 1).уаше = 
TVPlugin.GetProgram Title(1); 
document.getElementByld('Start' + 1).уаше = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram StartTime(1) ); 
document.getElementB yId('End' + 1).value = 
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TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 
document.getElementB yId('Duration' + i).value = 

TVPlugin.GetProgram Duration(1): 

) 


Support from ТІМЕ-0001 
Security Type | TVInfo 


4.18.1.2. GetEpochTime 


Function 
GetEpochTime 


GetEpochTime function returns a current epoch time(UTC) 


If success, returns a current epoch time(UTC) 
Return Value . . 
otherwise, returns negative value 


Emulator 
none 
remarks 


var epochTime - TimePlugin.GetEpochTime(); 
TVPlugin.GetProgramList(epochTime, 3600); 
var programListSize = TVPlugin.GetProgramList Size(); 
if( programListSize > 5 ) 
Example ( 
programListSize - 5; 
for(var 1-0 ; i<programListSize ; ++i) 
{ 
document.getElementB yId('Title' + i).value = 
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TVPlugin.GetProgram Title(1); 
document.getElementB yId('Start' + 1).уаше = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram StartTime(1) ); 
document.getElementB yId('End' + 1).value = 
TimePlugin.ConvertEpochToLocalTime( TVPlugin.GetProgram_EndTime(i) ); 
document.getElementB yId('Duration' + i).value = 
TVPlugin.GetProgram Duration(i); 
) 


Support from ТІМЕ-0001 
Security Type | TVInfo 


4.19. Video 
4.19.1. Function 


4.19.1.1. ChangeWidgetMode 


Function 
ChangeWidgetMode 
This function process underneath widget side when an widget changes from Full mode to Partial Mode or from Partial 


mode to Full mode. So widget should call this function when Full/Partial mode to be changed. 


ChangeWidgetMode( PL VIDEO WIDGET MODE widgetMode ) 


e  widgetMode 
o PL VIDEO WIDGET MODE 
Parameter 
o Full or Partial 


ЕШ If success, returns PLR TRUE. 
Return Value 
Otherwise, returns error code. 
Full mode : Widget covers full Screen(960x540) 
Remarks 
Partial Mode : Widget doesn't cover full screen, only part of DTV screen. 


Emulator 


[FAKE] Do nothing, just print out function name on debug console in SDK. 
remarks 


VideoPlugin.ChangeWidgetMode(PL VIDEO WIDGET MODE, FULL); 
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// switch to Full screen widget 
VideoPlugin.ChangeWidgetMode(PL VIDEO WIDGET MODE PART); 
// switch to Partial screen widget 


“ РІ, VIDEO WIDGET MODE 
Enumeration 


Support from VIDEO-0001 
Security Type | System 


4.19.1.2. SetFrameRate 


Function 
SetFrameRate (Replaced) 
Change whether the frame rate of the screen should be changed or not 


If any problem occurs when frame rate is changed, then a widget can fix the frame rate to avoid the problem. 


SetFrameRate( Number IsFixedFrameRate ) 


е  IsFixedFrameRate 
o Number 


Parameter 
o 1: fixed 0: not fixed 


If success, returns PLR TRUE. 
Return Value 
Otherwise, returns error code. 


This function is replaced with SetOption(PL SCREEN OPTION FIXED FRAME RATE) 
function in Screen plugin 

Remarks 
When some video contents is played, screen frame rate is changed automatically, and the screen 
has some noise. In this case, widgets can fix frame rate using this function. 


Emulator 


[FAKE] Do nothing, just print out function name on debug console in SDK. 
remarks 
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4.19.1.3. SetOSDState 


Function 


SetOSDState 


Set screen enhancement function (MJC) on / off. 
SetOSDState( Number handle , Number x , Number у , Number w , Number В, 
Syntax 
T Number OSDState ) 


е handle 
Number 
Handle value. The same value should be used for SetOSDState( PLR ТЕСЕ) 
and SetOSDState( PLR FALSE ) 


Number 


X(hor) coordinate of starting position 


Number 

Y(ver) coordinate of starting position 
Parameter 

Number 


Width of region 


o Number 

o Height of region 
OSDState 

o Number 


о 1:MJC off, 0: МІС On 
If success, returns PLR, TRUE. 
Return Value 
Otherwise, returns error code. 
When some widgets are displayed on some panels, when hiding the widget, sometimes a 
Remarks rectangle remains from the widget. In this case, the widget should use this function to avoid the 
problem with the remaining rectangle. 


Emulator 


[FAKE] Do nothing, just print out function name on debug console in SDK. 


remarks 


... MIC Off... 
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VideoPlugin.SetOSDState( 1,100, 100, 100, 100, PLR ТКОБ); 
.. MJC On .. 
VideoPlugin. SetOSDState(1., 100, 100, 100, 100, PLR FALSE); 


Support from VIDEO-0003 
Security Туре 


4.19.2. Enumeratioin 


4.19.2.1. PL VIDEO WIDGET MODE 


Enumeration 
PL VIDEO WIDGET MODE 


Widget type based on a size ( full or part ) 


Emulator 
none 
remarks 
e  ChangeWidgetMode 


e 0 - PL VIDEO WIDGET MODE FULL 
o Fullscreen widget mode 
e 1- PL VIDEO WIDGET MODE PART 
Value 
o Partial screen widget mode(ex: Partial widget manager, UCC widget mode for 
playing video contents) 


4.20. Window 


4.20.1. Function 


4.20.1.1. CheckScreenRect PosSizeMode 


Function 


CheckScreenRect PosSizeMode 
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CheckScreenRect PosSizeMode function checks whether you can change TV screen state to PosMode and SizeMode of 
parameters 


CheckScreenRect PosSizeMode( PL WINDOW POSITION MODE PosMode 5 
Syntax 
d PL WINDOW RECT SIZE MODE SizeMode ) 


е PosMode 
o PL WINDOW POSITION MODE 
o enumeration of screen left, top coordinates 
Parameter e  SizeMode 
o PL WINDOW RECT SIZE MODE 
o enumeration of screen width, height 


Return If success, returns positive value 
Value otherwise, returns negative value 
Remarks 


Emulator . 
Returns true about all input parameter values. 
remarks 


var result; 


// PL WINDOW POSITION MODE value is defined in refrence file PluginTV.js 


result = 
WindowPlugin.CheckScreenRect PosSizeMode(PL WINDOW POSITION MODE 
DEFAULT, PL WINDOW RECT SIZE MODE DEFALUT); 


if( result » 0 ) 
{ 


Example 


WindowPlugin.SetScreenRect PosSizeMode(PL WINDOW POSITION M 
ODE DEFAULT, PL WINDOW RECT SIZE MODE DEFALUT); 
) 


else 


{ 
// Error 


Enumerati 
е PL WINDOW POSITION MODE 
on 
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ШЕ e РІ, WINDOW ВЕСТ SIZE, MODE 


Support from WINDOW-0001 


Security 
TVInfo 


Type 


4.20.1.2. GetCurrentChannel Major 


Function 
GetCurrentChannel Major 


GetCurrentChannel Major function returns a major number ( ex: "11" from "11-1" ) of a current channel number 


GetCurrentChannel Major( ) 
If success, returns a major number of a current channel number 
Return Value . . 
otherwise, returns negative value 


Emulator There are only four channel(1-1, 2-1, 3-1, 4-0) in the emulator. 


remarks Returns a major number of a current virtual channel supported by the emulator. 


var major = WindowPlugin.GetCurrentChannel Major(); 

var minor = WindowPlugin.GetCurrentChannel Minor(); 
Example 

var channelNumber = major + "-" minor; 


Support from WINDOW-0001 
Security Type 


4.20.1.3. GetCurrentChannel Minor 


Function 


GetCurrentChannel Minor 


GetCurrentChannel Minor function returns a minor number ( ex: "1" from "11-1" ) of a current channel number 


GetCurrentChannel Minor( ) 
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Parameter 
If success, returns a minor number of a current channel number 
Return Value : . 
otherwise, returns negative value 


Remarks 


Emulator There are only four channel(1-1, 2-1, 3-1, 4-0) in the emulator. 


remarks Returns a major number of a virtual channel supported by the emulator. 


var major = WindowPlugin.GetCurrentChannel Major): 

var minor = WindowPlugin.GetCurrentChannel Minor(); 
Example 

var channelNumber = major + "-" + minor; 


Support from WINDOW-0001 
Security Type 


4.20.1.4. GetCurrentChannel Name 


Function 


GetCurrentChannel Name 


GetCurrentChannel Name function returns a name of a current channel( ex : "BBC" ) 


GetCurrentChannel Name( ) 


If success, returns a name of a current channel 
Return Value 


otherwise, returns negative value 


Channel name is supported in only digital channel. There is no channel name in analog channel 


Emulator 


Returns a virtual current channel name. 
remarks 


var name = WindowPlugin.GetCurrentChannel, Name(); 
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Enumeration none 


Support from WINDOW-0001 
Security Type 


4.20.1.5. GetCurrentChannel OriginNetID 


Function 


GetCurrentChannel OriginNetID 


GetCurrentChannel OriginNetID function returns a OriginNetID of a current channel 


GetCurrentChannel OriginNetID( ) 
If success, returns a OriginNetID of a current channel 
Return Value . . 
otherwise, returns negative value 


Emulator 
Body is empty, returns false 
remarks 


Support from WINDOW-0001 


4.20.1.6. GetCurrentChannel ProgramNumber 


Function 
GetCurrentChannel ProgramNumber 


GetCurrentChannel ProgramNumber function returns a program number of a current channel 


GetCurrentChannel ProgramNumber( ) 


If success, returns a program number of a current channel 
Return Value . . 
otherwise, returns negative value 
Remarks none 
Emulator Returns a current program number in a virtual channel. 
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| wears | 000000000000 
var programNumber = WindowPlugin.GetCurrentChannel ProgramNumber(); 


Support from WINDOW-0001 
Security Type 


4.20.1.7. GetCurrentChannel PTC 


Function 
GetCurrentChannel PTC 


GetCurrentChannel PTC function returns a PTC of a current channel 


GetCurrentChannel PTC( ) 
If success, returns a PTC of a current channel 
Return Value | . 
otherwise, returns negative value 


Emulator 
Returns a virtual PTC of a current channel. 
remarks 


var РТС = WindowPlugin.GetCurrentChannel PTC(); 


4.20.1.8. GetCurrentChannel ServiceName 


Function 


GetCurrentChannel ServiceName 


GetCurrentChannel ServiceName function returns a ServiceName of a current channel 


GetCurrentChannel ServiceName( ) 


Parameter 


If success, returns a ServiceName of a current channel 


Return Value : . 
otherwise, returns negative value 


Remarks 
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Emulator 
Boldy is empty, returns only false 


remarks 


var serviceName = WindowPlugin.GetCurrentChannel ServiceName(); 
xample 


Support from WINDOW-0001 
Security Type Channel 


4.20.1.9. GetCurrentChannel Type 


Function 
GetCurrentChannel Type 
GetCurrentChannel Type function returns a type( AnalogTV, DigitalTV, Cable AnalogTV, CableDigitalTV, ... ) of a 


current channel 


GetCurrentChannel Type( ) 


If success, returns a type of a current channel (PL WINDOW CHANNEL TYPE) 
Return Value 
otherwise, returns negative value 


Emulator Supports three digital channel(1-1,2-1,3-1) and one analog channel(4-0) 


remarks Returns a channel type of a current virtual channel supported by the emulator. 


var type = WindowPlugin.GetCurrentChannel Туре(); 


Example 


Е е ІРІ, WINDOW CHANNEL ТҮРЕ 
Enumeration 


Version Support from WINDOW-0001 


Security Type 


4.20.1.10.  GetResolution 


Function 


GetResolution 


GetResolution function returns a resolution of video layer( ex : 720P, 10801, NoSignal, NotSupported, ... ) 


GetResolution( ) 
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Parameter 


If success, returns a resolution of video layer( ex : 720P, 10801, NoSignal, NotSupported, ... ) 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator 


Boldy is empty, returns only false 


remarks 


if PL WINDOW SHOW STATE START != WindowPlugin.GetState Show() ) 
{ 
Example WindowPlugin.Show(PL WINDOW SHOW TYPE START): 
Enumeration 


Support from WINDOW-0001 
Security Type | TVInfo 


4.20.1.11. GetScreenRect 


Function 


GetScreenRect 


GetScreenRect function returns a screen size(left, top, width, height) of a video layer 


If success, returns a string that each value is connected with "/" ( ex : 0010/0010/0320/0240 ) in 
Return Value 
otherwise, returns negative value 


Emulator remarks | Returns rectangle area values of the screen in the emulator. 
var type - WindowPlugin.GetScreenRect(); 
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Support from WINDOW-0001 


Security Type TVInfo 


4.20.1.12.  GetScreenRect PosMode 


Function 


GetScreenRect PosMode 


GetScreenRect PosMode function returns a enumeration of screen left, top coordinates of video layer 
GetScreenRect PosMode( ) 


Return If success, returns a enumeration of screen left, top coordinates 
Value otherwise, returns negative value 
Remarks 


Emulator " | 
Returns a position mode of the screen in the emulator. 
remarks 


if( (PL WINDOW POSITION MODE DEFAULT != 
WindowPlugin.GetScreenRect_PosMode() ) || 
(PL WINDOW RECT SIZE MODE DEFALUT != 
WindowPlugin.GetScreenRect SizeMode() ) 
Example | 
WindowPlugin.SetScreenRect PosSizeMode(PL WINDOW POSITION M 


ODE DEFAULT, PL WINDOW RECT SIZE MODE DEFALUT); 


PL WINDOW POSITION MODE 


Support from WINDOW-0001 
Security 
TVInfo 
Type 


4.20.1.13.  GetScreenRect SizeMode 


Function 


GetScreenRect SizeMode 
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GetScreenRect SizeMode function returns a enumeration of screen size(width, height) of the video layer 
GetScreenRect SizeMode( ) 


Return If success, returns a enumeration of screen size(width, height) of the video layer 
Value otherwise, returns negative value 


Emulator 


Returns a size mode of the screen in the emulator. 
remarks 


if( (PL WINDOW POSITION MODE DEFAULT != 
WindowPlugin.GetScreenRect_PosMode() ) | 
(PL WINDOW RECT SIZE MODE DEFALUT !- 
WindowPlugin.GetScreenRect SizeMode() ) 
Example | 
WindowPlugin.SetScreenRect PosSizeMode(PL WINDOW POSITION M 


ODE DEFAULT, PL WINDOW RECT SIZE MODE DEFALUT); 
) 


Enumerati е PL WINDOW RECT SIZE MODE 


on 
Support from WINDOW-0001 
Security 
TVInfo 
Type 


4.20.1.14. Себошсе 


Function 


GetSource 


GetSource function returns a current source. (TV or PC or DVI ...) 


If success, returns а current source (PL WINDOW SOURCE) 
Return Value 
otherwise, returns negative value 


Remarks 


Emulator 
Boldy is empty, returns only false 
remarks 
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if PL WINDOW SOURCE MEDIA != WindowPlugin.GetSource() ) 
{ 
Ехатріе WindowPlugin.SetSourcePL WINDOW SOURCE MEDIA); 


PL WINDOW SOURCE 
Enumeration 


Support from WINDOW-0003 
Security Type | TVInfo 


4.20.1.15. Себе Show 


Function 
GetState Show 


GetState Show function returns a state of video layer( ех: Play, NoSignal, ... ) 


If success, returns a state of video layer( ех: Play, NoSignal, ... ) 
Return Value : . 
otherwise, returns negative value 


Emulator . : 
Returns a virtual set viedeo state. 
remarks 


if PL WINDOW SHOW STATE START != WindowPlugin.GetState Show() ) 
{ 
Example WindowPlugin.Show(PL WINDOW SHOW TYPE START); 
Enumeration 


Support from WINDOW-0001 
Security Type | TVInfo 
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4.20.1.16.  SetSource 


Function 


SetSource 


SetSource function chage current source. (TV or PC or DVI ...) 


SetSource( PL WINDOW SOURCE source ) 


e source 
о РІ, WINDOW SOURCE 
Parameter 
o Source 


If success, returns a positive value 
Return Value А | 
otherwise, returns negative value 


Remarks 


Emulator 
Boldy is empty, returns only false 
remarks 


if PL WINDOW SOURCE MEDIA != WindowPlugin.GetSource() ) 
{ 
Example WindowPlugin.SetSource(PL WINDOW SOURCE MEDIA); 
Enumeration 


Support from WINDOW-0003 
Security Type | TVInfo 


4.20.2. Enumeration 


4.20.2.1. PL WINDOW CHANNEL TYPE 


Enumeration 
PL WINDOW CHANNEL TYPE 


none 
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е  GetCurrentChannel Туре 


РІ, WINDOW CHANNEL ТҮРЕ UNKNOWN 

o Unknown channel 

PL WINDOW CHANNEL TYPE TV 

o TV 

PL WINDOW CHANNEL TYPE ATV 

o Analog TV 

PL WINDOW CHANNEL TYPE DTV 

o Digital TV 

PL WINDOW CHANNEL TYPE CATV 

o Cable analog TV 

PL WINDOW CHANNEL TYPE CDTV 
Value o Cable digital TV 

PL WINDOW CHANNEL TYPE PATV 

o POD analog TV 

PL WINDOW CHANNEL TYPE PDTV 

о POD digital TV 

PL WINDOW CHANNEL TYPE SDTV 

о SDTV 

PL WINDOW CHANNEL TYPE FREESAT 

o  Freesat 

10 - PL WINDOW CHANNEL TYPE MEDIA 
o Media 


4.20.2.2. PL WINDOW NAVIGATOR MODE 


Enumeration 


PL WINDOW NAVIGATOR MODE 


none 


Remarks 


Emulator 
none 
remarks 
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е SetChannel Seek 
Function 


PL WINDOW NAVIGATOR MODE ALL 
o ©All channel 
PL_WINDOW_NAVIGATOR_MODE_DIGITAL 


o Digital channel 


PL WINDOW NAVIGATOR MODE ANALOG 
о Analog channel 

PL WINDOW NAVIGATOR MODE FAVORITE 
o  Favirite channel 
PL WINDOW NAVIGATOR MODE CURR TYPE 
o  Unsed 
PL WINDOW NAVIGATOR MODE EXCEPT ADDDEL 


o  Unsed 


PL WINDOW NAVIGATOR MODE ANALOG ALL 


o  Unsed 


4.20.2.3. PL WINDOW POSITION MODE 


Enumeration 
PL WINDOW POSITION MODE 


none 


Remarks 


Emulator 
none 
remarks 


CheckScreenRect PosSizeMode 


GetScreenRect PosMode 


Function 
SetScreenRect PosSizeMode 
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PL WINDOW POSITION MODE TOPLEFT 


О 


Set 


screen position of video layer to Top Left. 


PL WINDOW POSITION MODE TOPRIGHT 


о 


Set 


screen position of video layer to Top Right. 


PL WINDOW POSITION MODE TOPCENTER 


о 


Set 


screen position of video layer to Top Center 


PL WINDOW POSITION MODE BOTTOMRIGHT 


о 


Set 


screen position of video layer to Bottom Right. 


PL WINDOW POSITION MODE BOTTOMLEFT 


О 


Set 


screen position of video layer to Bottom Left. 


PL WINDOW POSITION MODE MIDDLELEFT 


О 


Set 


Window positon to Middle Left. 


PL WINDOW POSITION MODE MIDDLECENTER 


О 


Set 


screen position of video layer to Middle Center. 


PL WINDOW POSITION MODE CUSTOM 


о 


Set 


screen position of video layer to custom(position by SetScreenRect) position. 


PL WINDOW POSITION MODE DEFAULT 


О 


Set 


screen position of video layer to defualt(Full screen) position. 


4.20.2.4. PL WINDOW RECT SIZE MODE 


Enumeration 


PL WINDOW RECT SIZE MODE 


Remarks 


Emulator 
none 
remarks 
е CheckScreenRect PosSizeMode 
е  GetScreenRect SizeMode 


Function 
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Ki e  SetScreenRect PosSizeMode 


PL WINDOW RECT SIZE PIP SMALL 


О 


Set 


PIP size small 


PL WINDOW RECT SIZE PIP LARGE 


О 


Set 


PIP size large 


PL WINDOW RECT SIZE PIP DOUBLE SMALL 


о 


Set 


PIP size double small 


PL WINDOW RECT SIZE PIP DOUBLE LARGE 


о 


Set 


PIP size double large 


PL WINDOW RECT SIZE PIG 


о 


Set 


PIP size PIG 


PL WINDOW RECT SIZE DEFALUT 


О 


Set 


PIP size default(Full screen) 


PL WINDOW RECT SIZE CUSTOM 


О 


Set 


PIP size custom(size by SetScreenRect) 


PL WINDOW RECT SIZE WIDEPC 


о 


Set 


PIP size wide PC 


PL WINDOW RECT SIZE PC 4 3 


О 


Set 


PIP size PC 4:3 


4.20.2.5. РІ, WINDOW RESOLUTION 


Enumeration 


PL WINDOW RESOLUTION 


PL WINDOW, RESOLUTION is enumeration value of the video layer resolution 


If a state of video layer is changed, resolution can be changed ( ex : If RF signal is disconnected, 
Remarks 
resolution is changed to NoSignal ) 


Emulator 
remarks 
: e  GetResolution 
Function 


е 0 - PL WINDOW RESOLUTION NOTSUPPORT 
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О 


NOTSUPPORT 


PL WINDOW RESOLUTION NOSIGNAL 


о 


NOSIGNAL 


PL WINDOW RESOLUTION NT 


О 


NT resolution for NTSC3 58 color system 


PL WINDOW RESOLUTION NT N 
NT N resolution for NTSC4 43 color system 


О 


PL WINDOW RESOLUTION PC 


О 


РС 


PL WINDOW RESOLUTION 10801 


О 


10801 


PL WINDOW RESOLUTION 1080P 


о 


1080Р 


PL WINDOW RESOLUTION 720P 


о 


720P 


PL WINDOW RESOLUTION 480P 


О 


480Р 


PL WINDOW RESOLUTION 4801 


о 


4801 


10 - РІ, WINDOW RESOLUTION, 640X480P 


О 


640 х 480Р 


11 - PL WINDOW RESOLUTION 1440x4801 


о 


1440Х4801 


12 - РІ, WINDOW RESOLUTION, 576P 


О 


576Р 


13 - РІ, WINDOW RESOLUTION, 5761 


О 


5761 


14 - PL WINDOW RESOLUTION PAL 


О 


PAL resolution for PAL color system 


15 - PL WINDOW RESOLUTION PAL M 


О 


PAL М “resolution for 


PAL M color system 


16 - PL WINDOW RESOLUTION PAL N 


о 


PAL N resolution for PAL N color system 


17 - PL WINDOW RESOLUTION SECAM 


О 


PAL N resolution for PAL N color system 


18 - PL WINDOW RESOLUTION YC SECAM 
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o YC SECAM 
18 - PL WINDOW RESOLUTION, NOVIDEO 
о МОУШЕО 
20 - PL WINDOW RESOLUTION UNKNOWN 


o Unknown Resolution 
21 - PL WINDOW RESOLUTION, UNSTABLE 

o  Unstable Resolution. to control AV Mute without showing banner 
22 - PL WINDOW RESOLUTION 2881 


o 352x288 resolution for MHEG. to control AV Mute without showing banner 


4.20.2.6. PL WINDOW SEEK 


Enumeration 


PL WINDOW SEEK 


Remarks 


Emulator 
none 
remarks 
Е.Б SetChannel Seek 
Function 


- PL WINDOW SEEK UNKNOWN 
o UNKNOWN 
PL WINDOW SEEK FAVORITE 
o  Favirite infomation 
PL WINDOW SEEK, CURRENT 
o Current information 
PL WINDOW SEEK UP 

ың о Next information that can be set 
PL WINDOW, SEEK DOWN 
o Previous information that can be set 
PL WINDOW SEEK FIRST 
o First information 
PL WINDOW SEEK, LAST 
o  Lastinformation 
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7 - PL WINDOW SEEK NEXT 
o Next information of input information 
8 - PL WINDOW SEEK PREV 
o Previous information of input information 


9 - PL WINDOW SEEK BACK 


o Information before changing to current information 


10 - PL WINDOW SEEK EXE 

o Set input information 
11 - PL WINDOW SEEK DIRECT 

o Set input information without checking whether it can be chagend 
12 - PL WINDOW SEEK TEMPORAL 


o After execution, change only current information 


4.20.2.7. PL WINDOW SHOW STATE 


Enumeration 


PL WINDOW SHOW STATE 


Emulator 
none 
remarks 
И е  GetState Show 
Function 


e 0 - PL WINDOW SHOW STATE OFF 

о Video layer show state is off 

PL WINDOW SHOW STATE NO SIGNAL 

o Video layer show state is no signal 

PL WINDOW SHOW STATE VCHIP 
Value o Video layer show state is vchip 

PL WINDOW SHOW STATE START 

o Video layer show state is start 

PL WINDOW SHOW STATE STOP 

o Video layer show state is stop 
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4.20.2.8. РІ, WINDOW SHOW ТҮРЕ 


Enumeration 


PL WINDOW SHOW TYPE 


Remarks 


Emulator 
none 
remarks 
Show 
0 БЕ 


- PL WINDOW SHOW ТҮРЕ OFF 
o Set video off 
PL WINDOW SHOW TYPE ON 
o Set video on 
PL WINDOW SHOW TYPE STOP 
o Set video stop 
PL WINDOW SHOW TYPE START 
Value o Set video start 
PL WINDOW SHOW TYPE NO SIGNAL 
o Set video nosignal ( If blue screen option is set, set video blue screen ) 
PL WINDOW SHOW TYPE VCHIP ON 
o Set video blue screen on (When vchip, child lock on) 
PL WINDOW SHOW TYPE VCHIP OFF 
o Set video blue screen off 


4.20.2.9. PL WINDOW SOURCE 


Enumeration 


PL WINDOW SOURCE 


Remarks 
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Emulator 
remarks 


GetSource 


Function SetSource 


PL WINDOW SOURCE TV 
o TV 
PL WINDOW SOURCE ATV 
o ATV 
PL WINDOW SOURCE DTV 
о DTV 
РІ, WINDOW SOURCE CATV 
о САТУ 
PL WINDOW SOURCE CDTV 
o CDTV 
PL WINDOW SOURCE PATV 
о РАТУ 
PL WINDOW SOURCE PDTV 
о РОТУ 
PL WINDOW SOURCE SDTV 
o SDTV 

11 - PL WINDOW SOURCE ATVI 
о АТУІ 

12 - PL WINDOW SOURCE ATV2 
о ATV2 

13 - PL WINDOW SOURCE DTVI 
о ТУІ 

14 - PL WINDOW SOURCE DTV2 
o DTV2 

15 - PL WINDOW SOURCE AVI 
o AVI 

16 - PL WINDOW SOURCE AV2 
о AV2 

17 - PL WINDOW SOURCE AV3 
o АУЗ 

18 - PL WINDOW SOURCE AV4 
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о АМ4 

- PL WINDOW SOURCE SVIDEO1 
о SVIDEOI 

- PL WINDOW SOURCE SVIDEO2 
о  SVIDEO2 

- PL WINDOW SOURCE SVIDEO3 
о SVIDEO3 

- PL WINDOW SOURCE SVIDEO4 
о SVIDEO4 

- PL WINDOW SOURCE COMPI 

o COMPI 

- PL WINDOW SOURCE COMP2 
о COMP2 

- PL WINDOW SOURCE COMP3 
o СОМРЗ 

- PL WINDOW SOURCE COMP4 
о СОМР4 

- PL WINDOW SOURCE PCI 

o PCI 

- PL WINDOW SOURCE PC2 

o PC2 

- PL WINDOW SOURCE PC3 

o PC3 

- PL WINDOW SOURCE PC4 

o PC4 

- PL WINDOW SOURCE HDMII 

o HDMII 

- PL WINDOW SOURCE HDMI2 
о HDMD 

- PL WINDOW SOURCE HDMI3 
o HDMB 

- PL WINDOW SOURCE HDM14 
o HDMI4 

- PL WINDOW SOURCE SCARTI 
о SCARTI 

- PL WINDOW SOURCE SCART2 
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о SCART2 

37 - РІ, WINDOW SOURCE, SCART3 
о 5САКТЗ 

38 - PL WINDOW SOURCE SCART4 
о SCART4 

39 - PL WINDOW SOURCE ОУП 
o РУП 

40 - PL WINDOW SOURCE DVD 
o DVD 

41 - PL WINDOW SOURCE DVI3 
o DVI3 

42 - PL WINDOW SOURCE DVIA 
о DVA 

43 - PL WINDOW SOURCE MEDIA 
o MEDIA 

44 - PL WINDOW SOURCE HOMING 
o DCRHOMING 

45 - PL WINDOW SOURCE NONE 


o No source 


5. Conclusion 


This document described the DeviceAPI introduction, method of use, and API list. We hope that this document helps 
widget or TV developers understand easy and exact Samsung Smart TV programming, which includes Samsung 
developers and 3" Party Content Providers. As а result, the Samsung Smart TV team wishes that many high quality 


widgets and software come into products, with the highest brand power. 
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